Retrieve Evaluator Version

GET

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

GET

/api/evaluators/:evaluator_id/versions/:version/

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

200Retrieved

1 {
2   "name": "string",
3   "created_at": "2024-01-15T09:30:00Z",
4   "updated_at": "2024-01-15T09:30:00Z",
5   "created_by": {
6     "id": 1,
7     "email": "string",
8     "name": "string",
9     "username": "string",
10     "first_name": "string",
11     "last_name": "string"
12   },
13   "updated_by": {
14     "id": 1,
15     "email": "string",
16     "name": "string",
17     "username": "string",
18     "first_name": "string",
19     "last_name": "string"
20   },
21   "id": "string",
22   "version_id": "string",
23   "version": 1,
24   "is_read_only": true,
25   "version_description": "string",
26   "description": "string",
27   "type": "llm",
28   "score_value_type": "numerical",
29   "score_config": {},
30   "passing_conditions": {},
31   "llm_config": {},
32   "code_config": {},
33   "configurations": {},
34   "categorical_choices": [
35     {}
36   ],
37   "eval_class": "ragas_faithfulness",
38   "starred": true
39 }

Get or edit a specific version by version number.

GET /api/evaluators/{evaluator_id}/versions/{version}/ - Get specific version PATCH /api/evaluators/{evaluator_id}/versions/{version}/ - Edit (only if is_read_only=False)

NOTE: DELETE is not allowed for specific versions. Delete the entire evaluator instead. Versions are immutable history - you can only add new versions, not remove old ones.

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

Get or edit a specific version by version number. GET /api/evaluators/{evaluator_id}/versions/{version}/ - Get specific version PATCH /api/evaluators/{evaluator_id}/versions/{version}/ - Edit (only if is_read_only=False) NOTE: DELETE is not allowed for specific versions. Delete the entire evaluator instead. Versions are immutable history - you can only add new versions, not remove old ones. Access control via NestedResourceMixin: org identity derived from parent evaluator. Superadmin: Can READ any version across all organizations via JWT. Regular users: Can only access versions in their organization.

Authentication

AuthorizationBearer

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

evaluator_idstringRequired

versionintegerRequired

Response

namestring<=255 characters

created_atdatetimeRead-only

updated_atdatetimeRead-only

created_byobject

updated_byobject

idstring<=255 characters

version_idstring<=255 characters

versioninteger-2147483648-2147483647

is_read_onlyboolean

version_descriptionstring

descriptionstring

typeenum

llm - Llm
code - Code
human - Human
function - Function
human_numerical - Human Numerical
human_categorical - Human Categorical
human_boolean - Human Boolean
human_text - Human Text
custom - Custom

score_value_typeenum

numerical - Numerical
boolean - Boolean
percentage - Percentage
single_select - Single Select
multi_select - Multi Select
text - Text
json - Json
comment - Comment
categorical - Categorical

score_configmap from strings to any

passing_conditionsmap from strings to any or null

llm_configmap from strings to any or null

code_configmap from strings to any or null

configurationsmap from strings to any

categorical_choiceslist of maps from strings to any

eval_classenum

starredboolean