v1

latestOpenAPI 3.0.02026-07-26492143.5 KB
Evaluations

List evaluations

Returns a cursor-paginated list of evaluation results for a specific agent, newest first. Only completed and failed evaluations are returned (transient states like queued/in_progress are excluded).

Each evaluation includes the grade, criteria pass/fail results, extracted data points, applied tags, and sentiment analysis.

get/agents/{agent_id}/evaluations

Path parameters

agent_idstring required

ID of the agent whose evaluations to list.

Query parameters

page_sizeinteger

Number of evaluations to return per page (1-100).

cursorstring

Pagination cursor from a previous response's next_cursor field.

grade'pass' | 'needs_review' | 'needs_attention'

Filter evaluations by grade.

Response

Paginated list of evaluation results.

next_cursorstring nullable

Pass this value as the cursor query parameter to fetch the next page. Null when there are no more results.