NOnodus-compute
Managed agents

Accept durable work before provisioning

Changed on

Reuse the same idempotency key and input after an uncertain response. A session key serializes stateful work. Missing session keys create independent state.

post/v1/agents/{id}/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

Headers

Idempotency-Keystring required

Stable key for this logical operation. Reuse the same key and body after an uncertain response.

Request body

inputunknown required
sessionstring
deadlinestring date-time

Response

Success

attempt_budget_usdnumber nullable

Immutable attempt reservation accepted for this logical run. Absent for the legacy allocation policy.

recovery_policy'checkpoint-v1'

Accepted application-state recovery policy. Omitted for revisions with explicit file recovery.

checkpoint_idstring

Current committed application-state checkpoint, including an empty baseline. This identity can differ from the latest capture reported by checkpoint_status.

checkpoint_status'pending' | 'ready' | 'committed' | 'failed'

Latest capture status. Ready means uploaded files are verified but not yet committed with the journal boundary.

checkpoint_errorstring

Failure code for the latest application-state capture. A failed capture does not replace committed recovery state.

last_checkpoint_atstring date-time

Commit time of the current useful application-state checkpoint. Omitted for empty baselines and runs without saved state.

payload_expiredboolean
idstring required
agent_idstring required
revisioninteger required
sessionstring
status'queued' | 'starting' | 'running' | 'waiting' | 'recovering' | 'blocked' | 'completed' | 'cancelled' required
reasonstring
inputunknown
resultunknown
deadlinestring date-time
next_wake_atstring date-time
created_atstring date-time
updated_atstring date-time
sandbox_idstring
exec_idstring
attemptinteger
segmentinteger
group_idstring

Present for a task belonging to a static agent group.

task_keystring
depends_onstring[]

Immutable prerequisite task keys within the group.

Changes

  • ba84c74aeec8Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 544fef290a54Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status