Get Run By Id

Storage and ownership

Start the example API server and create a run or precreate a session. Keep the returned session_id. Use db_id when multiple registered databases exist; selecting table requires db_id and a configured adapter. It does not create a table on demand.

The session-type query parameter is type=agent, type=team or type=workflow. JWT user isolation is opt-in; non-admin service-account PAT callers always self-scope. A supplied user_id is a filter for unscoped callers, not permission to access another owner's records. Configured authorization also requires the relevant session read, write or delete scope.

Use the stored session ID and a run belonging to it. The returned API run projection uses run_input and an ISO 8601 created_at, for example "2026-09-07T09:00:00Z". The generated epoch timestamp example below is not this projection's current timestamp format. The component's raw run-polling API is a different representation.

GET/sessions/{session_id}/runs/{run_id}

Retrieve a specific run by its ID from a session. Response schema varies based on the run type (agent run, team run, or workflow run).

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

session_id*Session Id

Session ID to get run from

run_id*Run Id

Run ID to retrieve

Query Parameters

type?|

Session type (agent, team, or workflow). If not provided, the run type is inferred from the run's own fields.

user_id?|

User ID to query run from

db_id?|

Database ID to query run from

table?|

Table to query run from

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/sessions/string/runs/string'
{  "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",  "parent_run_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0",  "agent_id": "basic-agent",  "user_id": "user_123",  "run_input": "Which tools do you have access to?",  "content": "I don't have access to external tools.",  "created_at": 1728499200}