Skip to main content
GET
/
api
/
agents
/
{agentId}
/
runs
/
{runId}
Get Agent Run
curl --request GET \
  --url https://api.example.com/api/agents/{agentId}/runs/{runId}
{
  "runId": "550e8400-e29b-41d4-a716-446655440001",
  "agentId": "550e8400-e29b-41d4-a716-446655440000",
  "roomId": "660e8400-e29b-41d4-a716-446655440002",
  "startTime": 1703001234567,
  "endTime": 1703001235890,
  "status": "completed",
  "events": [
    {
      "type": "action:started",
      "timestamp": 1703001234600,
      "data": { "action": "REPLY" }
    },
    {
      "type": "model:used",
      "timestamp": 1703001234800,
      "data": {
        "modelType": "text:large",
        "provider": "openai",
        "tokens": { "prompt": 150, "completion": 50 }
      }
    },
    {
      "type": "action:completed",
      "timestamp": 1703001235800,
      "data": { "action": "REPLY", "success": true }
    }
  ],
  "tokensUsed": {
    "promptTokens": 150,
    "completionTokens": 50,
    "totalTokens": 200
  },
  "errors": []
}
Get detailed information about a specific agent run, including the full event history.

​
Path Parameters

​
agentId
string
required
The UUID of the agent
​
runId
string
required
The UUID of the run

​
Response

​
runId
string
Unique run identifier
​
agentId
string
Agent that executed this run
​
roomId
string
Room where the run occurred
​
startTime
number
Unix timestamp when run started
​
endTime
number
Unix timestamp when run ended
​
status
string
Run status: completed, failed, timeout, cancelled
​
events
array
Full event history for this run
​
tokensUsed
object
Token usage summary
​
errors
array
Array of error messages if any occurred
{
  "runId": "550e8400-e29b-41d4-a716-446655440001",
  "agentId": "550e8400-e29b-41d4-a716-446655440000",
  "roomId": "660e8400-e29b-41d4-a716-446655440002",
  "startTime": 1703001234567,
  "endTime": 1703001235890,
  "status": "completed",
  "events": [
    {
      "type": "action:started",
      "timestamp": 1703001234600,
      "data": { "action": "REPLY" }
    },
    {
      "type": "model:used",
      "timestamp": 1703001234800,
      "data": {
        "modelType": "text:large",
        "provider": "openai",
        "tokens": { "prompt": 150, "completion": 50 }
      }
    },
    {
      "type": "action:completed",
      "timestamp": 1703001235800,
      "data": { "action": "REPLY", "success": true }
    }
  ],
  "tokensUsed": {
    "promptTokens": 150,
    "completionTokens": 50,
    "totalTokens": 200
  },
  "errors": []
}