Agents

List agent runs

List recent runs for an agent with optional filtering.

get/agent/{agent_id}/runs

Request

Base URL
https://api.mosaic.so
URL
https://api.mosaic.so/agent/{agent_id}/runs
Auth
- HTTP bearer
- or API key in header X-API-Key

Path parameters

agent_idstring required

The ID of the agent

Query parameters

statusstring

Comma-separated statuses to filter by

fromstring date-time

ISO timestamp for earliest run

tostring date-time

ISO timestamp for latest run

limitinteger

Number of runs to return (max 100)

cursorstring date-time

Cursor for pagination (created_at timestamp)

folder_idstring

Exact triggered_by.source_folder_id provider folder ID.

batch_idstring

Exact triggered_by.batch_window_id batch UUID.

batch_keystring

Exact persisted batch grouping key.

storage_trigger_idstring

Exact persisted storage_trigger_subscription_id UUID.

production_idstring

Exact persisted production_id.

Response

Agent runs retrieved successfully

next_cursorstring date-time nullable

Pagination cursor for the next page

Example response

{
  "runs": [
    {
      "triggered_by": {
        "type": "youtube",
        "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "video_id": "dQw4w9WgXcQ",
        "video_title": "New upload",
        "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "triggered_at": "2026-03-08T21:14:12.000Z",
        "trigger_id": "1f8bc8f7-1f77-4ff0-bdf8-8db4bf999999",
        "target_video_input_agent_node_id": "eb3cc4be-8f0e-4ca0-9d92-1a6a44aaaaaa"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.