Skip to main content
GET
/
sessions
/
{session_id}
/
runs
/
{run_id}
{
  "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
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
session_id
string
required

Session ID to get run from

​
run_id
string
required

Run ID to retrieve

Query Parameters

​
type
enum<string>
default:agent

Session type (agent, team, or workflow)

Available options:
agent,
team,
workflow
​
user_id
string | null

User ID to query run from

​
db_id
string | null

Database ID to query run from

Response

Run retrieved successfully

  • RunSchema
  • TeamRunSchema
  • WorkflowRunSchema
​
run_id
string
required

Unique identifier for the run

​
parent_run_id
string | null

Parent run ID if this is a nested run

​
agent_id
string | null

Agent ID that executed this run

​
user_id
string | null

User ID associated with the run

​
run_input
string | null

Input provided to the run

​
content

Output content from the run

​
run_response_format
string | null

Format of the response (text/json)

​
reasoning_content
string | null

Reasoning content if reasoning was enabled

​
reasoning_steps
Reasoning Steps · object[] | null

List of reasoning steps

​
metrics
Metrics · object

Performance and usage metrics

​
messages
Messages · object[] | null

Message history for the run

​
tools
Tools · object[] | null

Tools used in the run

​
events
Events · object[] | null

Events generated during the run

​
created_at
string<date-time> | null

Run creation timestamp

​
references
References · object[] | null

References cited in the run

​
reasoning_messages
Reasoning Messages · object[] | null

Reasoning process messages

​
session_state
Session State · object

Session state at the end of the run

​
images
Images · object[] | null

Images included in the run

​
videos
Videos · object[] | null

Videos included in the run

​
audio
Audio · object[] | null

Audio files included in the run

​
files
Files · object[] | null

Files included in the run

​
response_audio
Response Audio · object

Audio response if generated

​
input_media
Input Media · object

Input media attachments