Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB
Diamond
evaluation-summaries

List Evaluation Summaries

List evaluation summaries for a team with optional filters and pagination.

Args: team_id: Team ID to list summaries for (required) agent_id: Optional filter by agent ID status: Optional filter by status (running, completed, failed, cancelled) harness_type: Optional filter by harness type tested_by: Optional filter by evaluation tool limit: Max number of results (default 10, max 100) offset: Number of results to skip for paging claims: JWT claims with user and team info summary_repo: Evaluation summary repository

Returns: Paginated list of evaluation summaries with total count

Raises: HTTPException: 401 if unauthorized, 403 if no permission

get/v1/evaluation-summaries/

Query parameters

team_idstring uuid required

Team ID to list summaries for

Team ID to list summaries for

agent_idstring uuid nullable

Filter by agent ID

Filter by agent ID

status'running' | 'completed' | 'failed' | 'cancelled'

Statuses for an evaluation run (mirrors the workflow lifecycle).

Filter by status (running, completed, failed, cancelled)

harness_type'standard' | 'custom' nullable

Filter by harness type (standard or custom)

Filter by harness type (standard or custom)

tested_by'diamond' | 'promptfoo' | 'garak' | 'pyrit'

Tools that can produce evaluation results.

Filter by tool that ran the evaluation

limitinteger

Maximum number of results to return

Maximum number of results to return

offsetinteger

Number of results to skip for paging

Number of results to skip for paging

Response

Successful Response

totalinteger required
limitinteger required
offsetinteger required