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": []
}