> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mosaic.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Resume Agent Run

> Resume a failed or cancelled run.

Resumes a failed or cancelled run by re-queueing eligible runtime nodes. Trigger/source nodes are excluded from resume.

## Request

```bash theme={null}
curl -X POST "https://api.mosaic.so/agent_run/[run_id]/resume" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Response

```json theme={null}
{
  "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.

## 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.