List Evaluation Sessions

GET

///apis/intake/v2/workspaces/:workspace/evaluations/:name/sessions

GET

/apis/intake/v2/workspaces/:workspace/evaluations/:name/sessions

curl /apis/intake/v2/workspaces/workspace/evaluations/name/sessions

{
  "data": [
    {
      "workspace": "string",
      "evaluation_name": "string",
      "session_id": "string",
      "trace_id": "string",
      "root_span_id": "string",
      "started_at": "2024-01-15T09:30:00Z",
      "status": "success",
      "test_case_name": "string",
      "ended_at": "2024-01-15T09:30:00Z",
      "latency_ms": 1.1,
      "input": "string",
      "output": "string",
      "input_tokens": 1,
      "output_tokens": 1,
      "cached_tokens": 1,
      "cost_total_usd": 1.1,
      "evaluator_scores": {},
      "failed_evaluators": [
        "string"
      ],
      "test_case_id": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 1,
    "current_page_size": 1,
    "total_pages": 1,
    "total_results": 1
  },
  "sort": "string",
  "filter": {}
}

Path parameters

workspacestringRequired

namestringRequired

Query parameters

pageintegerOptional>=1Defaults to 1

Page number.

page_sizeintegerOptional1-1000Defaults to 100

Page size.

modeenumOptionalDefaults to detailed

Response mode. summary omits root-span input and output; preview includes both truncated to 300 characters; detailed returns full root-span payloads.

Allowed values:

sortstringOptional

Comma-separated list of fields to sort by, applied in order (the first field dominates); prefix a field with ’-’ for descending — e.g. ‘-cost_total_usd,latency_ms’. Fields: test_case_name, started_at, ended_at, latency_ms, status, cost_total_usd, tokens. When omitted, sessions are ordered by started_at ascending.

Comma-separated list of fields to sort by, applied in order (the first field dominates); prefix a field with '-' for descending — e.g. '-cost_total_usd,latency_ms'. Fields: test_case_name, started_at, ended_at, latency_ms, status, cost_total_usd, tokens. When omitted, sessions are ordered by started_at ascending.

filterobjectOptional

Filter sessions by test_case_name and status.

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

400

Bad Request Error

404

Not Found Error

413

Content Too Large Error

422

Unprocessable Entity Error

503

Service Unavailable Error