Skip to main content
POST
Resume Agent Run
Resumes a failed or cancelled run by re-queueing eligible runtime nodes. Trigger/source nodes are excluded from resume.

Request

Response

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.

Credit-blocked runs (needs_credits)

Use this endpoint to continue runs that failed because of insufficient credits:
  1. Detect credit-blocking via GET /agent_run/{run_id} (needs_credits: true) and/or GET /agent_run/{run_id}/nodes (nodes[].needs_credits: true).
  2. Check the current plan with GET /plan.
  3. If you are on a free/no paid plan:
    • List purchasable plans with GET /plan/list.
    • Upgrade with POST /plan/upgrade.
    • If upgrade returns requires_checkout: true, complete checkout at checkout_url, then re-check GET /plan.
  4. Optionally enable auto top-ups with POST /credits/settings (eligible plans only: creator, creator_annual, professional, professional_annual).
  5. Call POST /agent_run/{run_id}/resume to re-queue eligible failed/blocked runtime nodes.