{"openapi":"3.1.0","info":{"title":"Testorax Public API","version":"1.0.0","description":"Subset of the Testorax REST surface for outside-agent discovery. Full agent guide: https://testorax.com/agents.md","contact":{"email":"support@testorax.com","url":"https://testorax.com/support"},"license":{"name":"Proprietary","url":"https://testorax.com/terms"}},"servers":[{"url":"https://testorax.com"}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Customer or admin API key. Get one at https://testorax.com/account/api-key."}}},"paths":{"/api/pricing":{"get":{"summary":"Public pricing — paid modes and per-plan run credits.","security":[],"responses":{"200":{"description":"Pricing JSON","content":{"application/json":{}}}}}},"/api/agents/index.json":{"get":{"summary":"Agent surface inventory (machine-readable).","security":[],"responses":{"200":{"description":"Surface inventory","content":{"application/json":{}}}}}},"/api/agents/onboarding":{"get":{"summary":"Agent onboarding — first command, decision table, 5-step loop.","security":[],"responses":{"200":{"description":"Onboarding envelope","content":{"application/json":{}}}}}},"/api/browser-capabilities":{"get":{"summary":"Closed-set browser-engine capability matrix.","security":[],"responses":{"200":{"description":"Capabilities matrix","content":{"application/json":{}}}}}},"/api/docs/index.json":{"get":{"summary":"Agent-readable docs index (slugs + canonical URLs).","security":[],"responses":{"200":{"description":"Docs index","content":{"application/json":{}}}}}},"/api/runs/start":{"post":{"summary":"Start a Testorax run (paid modes: fast_bug_scan, workflow_test, full_crud_e2e, regression_check, authenticated_smoke).","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Target URL (must be public — Testorax cannot reach localhost)."},"mode":{"type":"string","enum":["fast_bug_scan","workflow_test","full_crud_e2e","regression_check","authenticated_smoke"]},"pagesLimit":{"type":"integer","minimum":1,"maximum":50},"scopedPaths":{"type":"array","items":{"type":"string"}},"authSessionId":{"type":"string","description":"For authenticated_smoke. Login Memory id of shape login_<22>. Customer creates this at /account/login-memory."},"viewport":{"type":"string","enum":["desktop","mobile","desktop_mobile"]}}}}}},"responses":{"200":{"description":"Run queued","content":{"application/json":{}}},"400":{"description":"Validation error"},"401":{"description":"Authentication required — see error envelope for CLI alternative"},"402":{"description":"payment_required — body includes Dodo checkoutUrl"}}}},"/api/runs/{runId}/report.json":{"get":{"summary":"Full run report (public-by-runId — the runId is the secret).","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"security":[],"responses":{"200":{"description":"Report JSON","content":{"application/json":{}}}}}},"/api/runs/{runId}/proof-pack.json":{"get":{"summary":"Full proof packet for an existing run (public-by-runId, redacted).","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"security":[],"responses":{"200":{"description":"Proof packet","content":{"application/json":{}}}}}},"/api/runs/{runId}/compact-proof":{"get":{"summary":"Compact decision-ready proof summary (public-by-runId, redacted, ~3KB).","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"security":[],"responses":{"200":{"description":"Compact proof JSON","content":{"application/json":{}}}}}},"/api/runs/{runId}/fix-check":{"post":{"summary":"Re-run the failing scenarios from a prior run to verify a fix landed.","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"ApiKey":[]}],"responses":{"200":{"description":"Fix Check queued","content":{"application/json":{}}},"401":{"description":"Authentication required"}}}}},"x-testorax":{"agentGuide":"https://testorax.com/agents.md","llmsTxt":"https://testorax.com/llms.txt","onboarding":"https://testorax.com/api/agents/onboarding","mcpServerCard":"https://testorax.com/.well-known/mcp/server-card.json","cliPackage":"https://www.npmjs.com/package/testorax","mcpPackage":"https://www.npmjs.com/package/testorax-mcp","sampleReport":"https://testorax.com/sample-report","notes":"This OpenAPI is a discovery aid only. Authoritative tool inventory: /agents.md. Authoritative MCP tool list: /.well-known/mcp/server-card.json."}}