Skip to main content
GET
/
agent_runs
List All Agent Runs
curl --request GET \
  --url https://api.example.com/agent_runs

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.

Returns run summaries across every agent your API key can access.

​
Request

curl -X GET "https://api.mosaic.so/agent_runs?limit=25&status=running,completed" \
  -H "Authorization: Bearer mk_your_api_key"

​
Query Parameters

FieldTypeRequiredDescription
limitnumberNoPage size (1-100, default 25).
cursorstringNoPagination cursor from next_cursor.
statusstringNoComma-separated statuses (running,completed).
fromstringNoISO timestamp lower bound on created_at.
tostringNoISO timestamp upper bound on created_at.
agent_idstringNoFilter runs to one agent ID.

​
Response

{
  "runs": [
    {
      "run_id": "7f8d9c2b-4a6e-8b3f-1d5c-9e2f3a4b5c6d",
      "agent_id": "123e4567-e89b-12d3-a456-789012345678",
      "status": "completed",
      "status_message": null,
      "started_at": "2026-03-02T09:00:00Z",
      "updated_at": "2026-03-02T09:06:00Z",
      "node_status_counts": {
        "completed": 10,
        "in_progress": 0,
        "failed": 0
      },
      "inputs": [],
      "outputs": [],
      "triggered_by": null
    }
  ],
  "next_cursor": null
}
outputs[] uses the same shape as Get Agent Run, including premiere_prproj_url when a Premiere Pro timeline package is attached to the render. This summary response does not include needs_credits. To check whether a run is credit-blocked, call Get Agent Run (run-level) and/or Get Agent Run Nodes (node-level).