Get Trace

GET

///apis/intake/v2/workspaces/:workspace/traces/:id

GET

/apis/intake/v2/workspaces/:workspace/traces/:id

curl /apis/intake/v2/workspaces/workspace/traces/id

{
  "id": "string",
  "session_id": "string",
  "workspace": "string",
  "started_at": "2024-01-15T09:30:00Z",
  "status": "success",
  "root_span_id": "string",
  "name": "string",
  "input": "string",
  "output": "string",
  "evaluation_context": {
    "evaluation_name": "string",
    "test_case_name": "string",
    "evaluation_id": "string",
    "test_case_id": "string"
  },
  "agent_name": "string",
  "agent_version": "string",
  "ended_at": "2024-01-15T09:30:00Z",
  "duration_ms": 1.1,
  "input_tokens": 1,
  "output_tokens": 1,
  "cached_tokens": 1,
  "total_tokens": 1,
  "cost_usd": 1.1,
  "cost_input_usd": 1.1,
  "cost_output_usd": 1.1,
  "models": [
    "string"
  ],
  "providers": [
    "string"
  ],
  "span_count": 1,
  "error_count": 1
}

Path parameters

workspacestringRequired

idstringRequired

Query parameters

modeenumOptionalDefaults to detailed

Response mode. summary returns root-span fields without payloads or rollups; preview adds token, cost, and span-count rollups plus 300-character input/output previews; detailed returns rollups and full payloads.

Allowed values:

Response

Successful Response

idstring

session_idstring

workspacestring

started_atdatetime

statusenum

Allowed values:

root_span_idstringOptional

namestringOptional

inputstringOptional

Root-span input text. Omitted in summary mode and truncated to 300 characters in preview mode.

outputstringOptional

Root-span output text. Omitted in summary mode and truncated to 300 characters in preview mode.

evaluation_contextobjectOptional

Identifies the Evaluation and optional test case associated with ingested telemetry.

agent_namestringOptional

agent_versionstringOptional

ended_atdatetimeOptional

duration_msdoubleOptional

input_tokensintegerOptional>=0

output_tokensintegerOptional>=0

cached_tokensintegerOptional>=0

total_tokensintegerOptional>=0

cost_usddoubleOptional

cost_input_usddoubleOptional

cost_output_usddoubleOptional

modelslist of stringsOptional

Distinct models used across the trace's spans. Omitted in summary mode.

providerslist of stringsOptional

Distinct inference providers used across the trace's spans. Omitted in summary mode.

span_countintegerOptional>=0

error_countintegerOptional>=0

Errors

422

Unprocessable Entity Error