Skip to main content
GET
/
agent
/
{agent_id}
/
runs
List Agent Runs
curl --request GET \
  --url https://api.example.com/agent/{agent_id}/runs
Lists recent runs for one agent.

​
Request

curl -X GET "https://api.mosaic.so/agent/[agent_id]/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 (for example: running,completed).
fromstringNoISO timestamp lower bound on created_at.
tostringNoISO timestamp upper bound on created_at.

​
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": [
        {
          "id": "7ba7b810-9dad-11d1-80b4-00c04fd430c8",
          "video_url": "https://storage.googleapis.com/mosaic-outputs/...",
          "thumbnail_url": "https://storage.googleapis.com/mosaic-thumbnails/...",
          "premiere_prproj_url": "https://storage.googleapis.com/mosaic-outputs/.../timeline.zip?...",
          "completed_at": "2026-03-02T09:06:00Z",
          "original_node_id": "2ba7b810-9dad-11d1-80b4-00c04fd430c8"
        }
      ],
      "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).