Evaluators Versions List

GET

https://api.respan.ai/evaluations/evaluators/:evaluator_id/versions/

GET

/evaluations/evaluators/:evaluator_id/versions/

$ curl https://api.respan.ai/evaluations/evaluators/evaluator_id/versions/ \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "count": 25,
3   "results": [
4     {
5       "name": "string",
6       "created_at": "2024-01-15T09:30:00Z",
7       "created_by": {
8         "id": 1,
9         "email": "string",
10         "name": "string",
11         "username": "string",
12         "first_name": "string",
13         "last_name": "string"
14       },
15       "id": "string",
16       "version_id": "string",
17       "version": 1,
18       "is_read_only": true,
19       "version_description": "string",
20       "description": "string",
21       "type": "llm",
22       "score_value_type": "numerical"
23     }
24   ],
25   "next": "string",
26   "previous": "string",
27   "total_count": 100,
28   "current_filters": {},
29   "filters_data": {}
30 }

List all versions or create new version (commit).

GET /api/evaluators/{id}/versions/ - List all versions POST /api/evaluators/{id}/versions/ - Commit (create new version)

Access control via NestedResourceMixin: org identity derived from parent evaluator. Superadmin: Can LIST all versions across all organizations via JWT. Regular users: Can only access versions in their organization.

List all versions or create new version (commit). GET /api/evaluators/{id}/versions/ - List all versions POST /api/evaluators/{id}/versions/ - Commit (create new version) Access control via NestedResourceMixin: org identity derived from parent evaluator. Superadmin: Can LIST all versions across all organizations via JWT. Regular users: Can only access versions in their organization.

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

evaluator_idstringRequired

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Response

countinteger

resultslist of objects

nextstring or nullformat: "uri"

previousstring or nullformat: "uri"

total_countinteger

current_filtersobject

Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters.

Each key is a metric name (str), and each value can be:

A single MetricFilterParamPydantic (one condition)
A List[MetricFilterParamPydantic] (multiple conditions for same metric)
A FilterBundlePydantic (nested filter bundle with connector)

Note: Uses extra=“allow” for dynamic metric name fields. The pydantic_extra annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.

filters_dataobject