Sandboxes

Commit an event and wake its sandbox driver

Account authentication is required. Receipt, immutable run, driver exec and normal lifecycle wake intent commit atomically. Exact source and event ID replay returns the same logical run. Changed command or payload conflicts. Normal billing, deadline, capacity and cleanup gates still apply. Queued events expire after seven days. Lost drivers have at most three attempts and unknown external effects block automatic restart.

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

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

sourcestring required
event_idstring required
commandstring[] required

Explicit driver argv, validated with normal exec bounds. No environment or stdin fields are accepted. Include the run identity in the command as required by your driver.

Response

Success

sourcestring required
event_idstring required
run_idstring required
exec_idstring required
state'queued' | 'running' | 'blocked' | 'handled' | 'expired' required
reasonstring required
created_atstring date-time required
expires_atstring date-time required

Changes

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