Get Session Runs

Retrieve all runs (executions) for a specific session. Runs represent individual interactions or executions within a session. Response schema varies based on session type.

GET /sessions/{session_id}/runs

Get Session Runs

cURL

curl --request GET \
  --url https://api.example.com/sessions/{session_id}/runs \
  --header 'Authorization: Bearer <token>'

200

{
  "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",
  "parent_run_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0",
  "agent_id": "basic-agent",
  "user_id": "",
  "run_input": "Which tools do you have access to?",
  "content": "I don't have access to external tools or the internet. However, I can assist you with a wide range of topics by providing information, answering questions, and offering suggestions based on the knowledge I've been trained on. If there's anything specific you need help with, feel free to ask!",
  "run_response_format": "text",
  "reasoning_content": "",
  "metrics": {
    "input_tokens": 82,
    "output_tokens": 56,
    "total_tokens": 138,
    "time_to_first_token": 0.047505500027909875,
    "duration": 4.840060166025069
  },
  "messages": [
    {
      "content": "<additional_information>\n- Use markdown to format your answers.\n- The current time is 2025-09-08 17:52:10.101003.\n</additional_information>\n\nYou have the capability to retain memories from previous interactions with the user, but have not had any interactions with the user yet.",
      "from_history": false,
      "stop_after_tool_call": false,
      "role": "system",
      "created_at": 1757346730
    },
    {
      "content": "Which tools do you have access to?",
      "from_history": false,
      "stop_after_tool_call": false,
      "role": "user",
      "created_at": 1757346730
    },
    {
      "content": "I don't have access to external tools or the internet. However, I can assist you with a wide range of topics by providing information, answering questions, and offering suggestions based on the knowledge I've been trained on. If there's anything specific you need help with, feel free to ask!",
      "from_history": false,
      "stop_after_tool_call": false,
      "role": "assistant",
      "metrics": {
        "input_tokens": 82,
        "output_tokens": 56,
        "total_tokens": 138
      },
      "created_at": 1757346730
    }
  ],
  "events": [
    {
      "created_at": 1757346730,
      "event": "RunStarted",
      "agent_id": "basic-agent",
      "agent_name": "Basic Agent",
      "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",
      "session_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0",
      "model": "gpt-4o",
      "model_provider": "OpenAI"
    },
    {
      "created_at": 1757346733,
      "event": "MemoryUpdateStarted",
      "agent_id": "basic-agent",
      "agent_name": "Basic Agent",
      "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",
      "session_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0"
    },
    {
      "created_at": 1757346734,
      "event": "MemoryUpdateCompleted",
      "agent_id": "basic-agent",
      "agent_name": "Basic Agent",
      "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",
      "session_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0"
    },
    {
      "created_at": 1757346734,
      "event": "RunCompleted",
      "agent_id": "basic-agent",
      "agent_name": "Basic Agent",
      "run_id": "fcdf50f0-7c32-4593-b2ef-68a558774340",
      "session_id": "80056af0-c7a5-4d69-b6a2-c3eba9f040e0",
      "content": "I don't have access to external tools or the internet. However, I can assist you with a wide range of topics by providing information, answering questions, and offering suggestions based on the knowledge I've been trained on. If there's anything specific you need help with, feel free to ask!",
      "content_type": "str",
      "metrics": {
        "input_tokens": 82,
        "output_tokens": 56,
        "total_tokens": 138,
        "time_to_first_token": 0.047505500027909875,
        "duration": 4.840060166025069
      }
    }
  ],
  "created_at": "2025-09-08T15:52:10Z"
}

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 runs from

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 runs from

created_after · integer | null

Filter runs created after this Unix timestamp (epoch time in seconds)

created_before · integer | null

Filter runs created before this Unix timestamp (epoch time in seconds)

db_id · string | null

Database ID to query runs from

Response

200

application/json

Session runs retrieved successfully

RunSchema

TeamRunSchema

WorkflowRunSchema

run_id · string · required

parent_run_id · string | null · required

agent_id · string | null · required

user_id · string | null · required

run_input · string | null · required

content · string Content · object · required

run_response_format · string | null · required

reasoning_content · string | null · required

reasoning_steps · Reasoning Steps · object[] | null · required

metrics · Metrics · object · required

messages · Messages · object[] | null · required

tools · Tools · object[] | null · required

events · Events · object[] | null · required

created_at · string<date-time> | null · required

references · References · object[] | null · required

reasoning_messages · Reasoning Messages · object[] | null · required

images · Images · object[] | null · required

videos · Videos · object[] | null · required

audio · Audio · object[] | null · required

files · Files · object[] | null · required

response_audio · Response Audio · object · required

input_media · Input Media · object · required