Skip to main content
Start a reusable Tool environment

Authorizations

Authorization
string
header
required

Opaque control credential

Headers

Idempotency-Key
string
required
Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$
environmentId
string
required
Pattern: ^env_[0-9a-z]{12,32}$

Body

application/json
buildHash
string
required

Exact immutable build selected before admission and retained for retries.

Pattern: ^sha256:[0-9a-f]{64}$
seed
string
required
Pattern: ^(0|[1-9]\d{0,19})$
scenarioId
string

Optional initial scenario. Omit to use the build baseline; creation does not run an agent.

Required string length: 1 - 96
Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
callbackReceiverBindingIds
string[]
Maximum array length: 64
Pattern: ^cbr_[0-9a-z]{12,32}$
ttlMs
integer
Required range: 0 < x <= 604800000

Response

Original operation receipt and current runtime on retry

schemaVersion
enum<number>
required
Available options:
1
projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$
environmentId
string
required
Pattern: ^env_[0-9a-z]{12,32}$
runtime
object
required
operation
object
required
replayed
boolean
required