Skip to main content
POST
Admit immutable snapshot bytes as a durable job

Authorizations

Authorization
string
header
required

Exactly one Authorization: Bearer value from the token file

Headers

Idempotency-Key
string
required
Required string length: 1 - 255

Body

application/json

Immutable byte-owned execution world. Unit bytes are canonical lowercase hexadecimal and digests are canonical lowercase SHA-256. The decoded unit aggregate is limited to 16 MiB and the complete encoded request to 33 MiB. This object is the request body itself, not a path-bearing wrapper.

digest
string
required
Pattern: ^[0-9a-f]{64}$
format_version
integer
required
root
string
required
Required string length: 1 - 4096
units
object[]
required
Maximum array length: 256

Response

Idempotent replay

id
string<uuid>
required
status
enum<string>
required
Available options:
queued,
running,
interrupted,
paused,
succeeded,
failed,
cancelled
error
object
execution_id
string
outputs
object

Declared workflow outputs; present only after settlement when supplied by the execution adapter

receipt
object

Terminal binding to the exact immutable admitted execution

trace_id
string