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

Session type (agent, team, or workflow)

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

User ID to query runs from

db_id
string | null

Database ID to query runs from

Response

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
required
run_response_format
string | null
required
reasoning_content
string | null
required
reasoning_steps
Reasoning Steps · object[] | null
required
metrics
object | null
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
I