List evaluator versions

List all versions of an evaluator, ordered newest first. Version 0 is the initial draft; committed versions are returned with is_read_only: true.

get/api/evaluators/{evaluator_id}/versions/

Path parameters

evaluator_idstring required

Evaluator ID. To run a specific version, pass an ID with a version suffix where supported, for example evl_abc123:2.

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of results to return per page. Maximum 100.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Response

Paginated evaluator versions.

countinteger required

Number of resources returned on this page.

nextstring nullable

URL for the next page, if any.

previousstring nullable

URL for the previous page, if any.

current_filtersApiEvaluatorsEvaluatorIdVersionsGetResponsesContentApplicationJsonSchemaCurrentFilters

Normalized filters applied to this request.

Changes

No recorded changes to this endpoint across all 1 revision of this API.