Queue a run of this suite

Returns 202 immediately with a durable queued run: request latency never depends on how long the suite takes to execute. The suite revision, its content hash and the compiled workflow snapshot are pinned at this moment, so an edit made while the run waits for a worker cannot change what it proves. idempotency_key is required and scoped to the organization -- replaying the same request returns the same run, and reusing one key for a different request is refused with 409. A run whose selected scenarios need a runner that is not deployed is refused with 422 unsupported_mode before anything is queued. Deterministic attempts make no model call and record a cost of zero; adaptive attempts are metered, and the run pins an upper-bound estimate, a model-call ceiling and the caller and evaluator identities before the first attempt starts. Nothing here is charged to a customer balance -- suite cost is reported by the simulation-suite ledger only.

post/v1/agents/{agent_id}/simulation-suites/{suite_id}/runs

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/agents/{agent_id}/simulation-suites/{suite_id}/runs
  • Auth: none declared

Path parameters

agent_idstring required
suite_idstring required

Request body

idempotency_keystring required
pinned_source'draft' | 'published'
scenario_idsstring[]

Run only these scenarios. Omit to run the whole suite.

Response

Durable queued run

Changes

No recorded changes to this operation across all 1 revision of this API.