Skip to main content
POST
/
agent_run
/
{run_id}
/
resume
Resume Agent Run
curl --request POST \
  --url https://api.example.com/agent_run/{run_id}/resume
Resumes a failed or cancelled run by re-queueing eligible runtime nodes. Trigger/source nodes are excluded from resume.

​
Request

curl -X POST "https://api.mosaic.so/agent_run/[run_id]/resume" \
  -H "Authorization: Bearer mk_your_api_key"

​
Response

{
  "success": true,
  "run_id": "7f8d9c2b-4a6e-8b3f-1d5c-9e2f3a4b5c6d",
  "agent_state_id": "7f8d9c2b-4a6e-8b3f-1d5c-9e2f3a4b5c6d",
  "nodes_queued": 4,
  "nodes_considered": 7,
  "requeued_nodes": 4,
  "requeued_node_tasks_detached": 4,
  "requeued_node_active_tasks_cancelled": 1,
  "requeued_node_active_tasks_total": 1
}

​
Notes

  • Run status must be failed or cancelled
  • Resume only re-queues runtime nodes (not_started, blocked, cancelled, failed)
  • Trigger node types are never resumed
  • Existing trigger metadata is preserved, and resume metadata is appended
If the run cannot be resumed in its current state, Mosaic returns 409 with a detail message.