Skip to content

Start a conformance run

Starts a go-live conformance run: `ingest`, `webhooks`, `writeback`, `outage_recovery` (turns on a 30-minute `unavailable` fault), `clock_skew` (±90 s), `backfill_10k`.

POST
/v1/sandbox/conformance

Starts a go-live conformance run: ingest, webhooks, writeback, outage_recovery (turns on a 30-minute unavailable fault), clock_skew (±90 s), backfill_10k.

Authorization

AuthorizationBearer <token>

OAuth 2.0 client credentials. private_key_jwt (SMART Backend Services asymmetric) is recommended; client secrets need an IP allowlist or mTLS outside the sandbox.

In: header

Scope: sandbox:write

Header Parameters

Api-Version?enum

Overrides the app's pinned dated version for this request.

Idempotency-Key?string

1–255 characters of [A-Za-z0-9._:-] (a UUID v4 is recommended); never PHI. Stored 24 hours per app.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/sandbox/conformance" \  -H "Content-Type: application/json" \  -d '{    "profile": "ingest"  }'
{  "checks": [    {      "evidence": "string",      "key": "string",      "status": "pending"    }  ],  "finishedAt": "2026-09-14T15:00:11.402Z",  "id": "run_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e",  "object": "conformance_run",  "profile": "ingest",  "startedAt": "2026-09-14T15:00:11.402Z",  "status": "running"}

Was this page helpful?