Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.argalabs.com/llms.txt

Use this file to discover all available pages before exploring further.

This reference documents endpoints that exist in the current validation-server checkout.

Available now

Product primitiveCurrent API surface
Spin up twins only/validate/twins/*
Deploy a repo branch or PR into a sandbox/sandboxes/*
Run a browser agent against a frontend/runner/runs/*
Save and run tests/runner/tests/*
Scenarios/scenarios/*
GitHub CI checks/validation/github/* and /validation/pr
Logs and artifacts/runs/*, /validate/{run_id}/results, artifact endpoints

Gaps to consider

NoteCurrent state
Runner compatibility alias/demo-runner/* is still mounted as a deprecated alias for /runner/*. New clients should use /runner/*.
Scenario twin environmentsThe docs previously described /scenarios/{scenario_id}/twin-environment, but that route is not present in this validation-server checkout. Use /sandboxes or /validate/twins/provision with scenario_id instead.
SDK-native CI checksNo separate CI endpoint exists for “use only twins from CI.” Today you can call the twins, scenarios, tests, sandboxes, and logs APIs from CI, or use the existing GitHub validation endpoints.
Public URL validation workflowPOST /validate/url-run exists, but it overlaps with runner runs and is not included as a core public primitive here.
Twin suggestion probingPOST /validate/url/probe exists, but it is more of a helper than a core product API.