Skip to content
Dashboard
Theme
Theme

Create a claimable test sandbox

POST /v1/sandboxes: Create a claimable test sandbox.

View Markdown

POST /v1/sandboxes

Requires Turnstile and rolling creation quotas. Keys are returned once. The claim token appears only in the claim URL fragment. The sandbox expires after seven days unless claimed. A deployment without a challenge verifier answers 503 sandbox_creation_unavailable (not retryable); a local deployment may accept any non-empty token instead (SANDBOX_LOCAL_CAPTCHA, refused at start-up outside DEPLOY_ENV=local). A new sandbox is seeded, where the test IdP runs, with a test organization whose SAML connection to the test IdP is pending its first test sign-in.

Scope
public
Auth
None
Since
1.0
  • turnstile_token string Required

    min length 1 · max length 2048

  • handoff_id string

    The handoff from createSandboxHandoff (the #handoff= fragment of its browser_url). With it, the keys and claim URL are sealed into the handoff for the CLI and the response is SandboxHandedOff; an expired, used or unknown handoff answers 410 sandbox_handoff_expired.

    min length 43 · max length 43

Errors share one shape; see the error code catalogue.

curl -X POST \
"https://api.ohauthcat.com/v1/sandboxes" \
-H "Content-Type: application/json" \
-d '{
"turnstile_token": "sk_test_example"
}'
Response 201
{
"environment": "env_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"secret_key": "sk_01J9ZQ4M7K2X8V3N5B6C1D0E9F",
"publishable_key": "pk_01J9ZQ4M7K2X8V3N5B6C1D0E9F",
"claim_url": "https://app.acme.com/callback",
"expires_at": "2026-01-15T09:30:00Z"
}