Skip to main content
GET
/
agent_run
/
{run_id}
Get Agent Run
curl --request GET \
  --url https://api.example.com/agent_run/{run_id}
Poll this endpoint to check the status of your agent run and retrieve outputs.

​
Request

curl -X GET "https://api.mosaic.so/agent_run/[run_id]" \
  -H "Authorization: Bearer mk_your_api_key"

​
Response

{
  "agent_id": "123e4567-e89b-12d3-a456-789012345678",
  "started_at": "2025-01-10T14:30:00Z",
  "status": "completed",
  "status_message": null,
  "node_status_counts": {
    "completed": 10,
    "in_progress": 0,
    "failed": 0
  },
  "inputs": [
    {
      "video_url": "https://storage.googleapis.com/mosaic-inputs/...",
      "thumbnail_url": "https://storage.googleapis.com/mosaic-inputs/..."
    }
  ],
  "outputs": [
    {
      "id": "7ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "video_url": "https://storage.googleapis.com/mosaic-outputs/...",
      "thumbnail_url": "https://storage.googleapis.com/mosaic-thumbnails/...",
      "completed_at": "2025-01-10T14:35:30Z",
      "original_node_id": "2ba7b810-9dad-11d1-80b4-00c04fd430c8"
    }
  ]
}

​
Output Fields

FieldTypeDescription
idstringUnique identifier for this output render
video_urlstringSigned URL to download the rendered video (valid for 7 days)
thumbnail_urlstring | nullSigned URL to download the video thumbnail
completed_atstringISO 8601 timestamp when this output finished rendering
original_node_idstring | nullTemplate agent_node_id this output originated from. Use this to map outputs to specific nodes in your agent.
Tracking outputs: Use original_node_id to identify which node in your agent template produced each output. This allows you to consistently map outputs to your application logic across multiple runs.

​
Status Values

StatusDescription
runningAgent is processing your videos
completedProcessing finished successfully
partial_completeSome outputs finished successfully, but others failed
failedThe entire run failed, no outputs generated
cancelledThe run was cancelled by the user