Sandboxes

Register immutable durable agent input

Requires an enabled durable-agent deployment. Repeating an identical run ID replays registration. Changed input, name, version or image conflicts. Registration does not start compute.

post/v1/sandboxes/{id}/agent-runs

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Request body

run_idstring required
namestring required
versionstring required
image_digeststring required
encoding'json-v1' required
inputstring byte required

Base64 of exact UTF-8 json-v1 bytes, at most 256 KiB decoded. Objects use sorted keys and compact encoding. Nonfinite numbers, duplicate keys and non-JSON values are refused.

Response

Success

run_idstring required
namestring required
versionstring required
image_digeststring required
status'active' | 'blocked' | 'completed' | 'cancelled' | 'expired' required
inputstring byte

Base64 of exact UTF-8 json-v1 bytes, at most 256 KiB decoded. Objects use sorted keys and compact encoding. Nonfinite numbers, duplicate keys and non-JSON values are refused.

resultstring byte

Base64 of exact UTF-8 json-v1 bytes, at most 256 KiB decoded. Objects use sorted keys and compact encoding. Nonfinite numbers, duplicate keys and non-JSON values are refused.

epochinteger required

Changes

No recorded changes to this operation across all 70 revisions of this API.