List Traces

GET

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

GET

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

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

{
  "data": [
    {
      "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
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 1,
    "current_page_size": 1,
    "total_pages": 1,
    "total_results": 1
  },
  "sort": "string",
  "filter": {}
}

Path parameters

workspacestringRequired

Query parameters

pageintegerOptional>=1Defaults to 1

Page number.

page_sizeintegerOptional1-1000Defaults to 10

Page size.

sortenumOptionalDefaults to -started_at

Allowed values:

modeenumOptionalDefaults to preview

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:

filterobjectOptional

Filter root-span-backed traces by id, session_id, root status, root span started_at, evaluation_name, test_case_name, and agent_name.

Response

Successful Response

datalist of objects

paginationobjectOptional

Pagination information.

sortstringOptional

The field on which the results are sorted.

filtermap from strings to anyOptional

Filtering information.

Errors

422

Unprocessable Entity Error