Skip to main content
POST
Submit a scenario batch

Authorizations

Authorization
string
header
required

An app API key, e.g. Authorization: Bearer sk_live_…. Secret (sk_) for writes/sessions; publishable (pk_) is read-only (browser-safe).

Headers

Idempotency-Key
string

A retried submit with the same key returns the original batchId without a second reservation.

Body

application/json

The canonical scenario spec (spec_version, domain, source, locked[], variants[], checks, budget). See the Scenario Studio spec module.

Response

Batch queued

batchId
string<uuid>
status
string
Example:

"queued"

schemaVersion
integer
Example:

1