Retrieve

GET

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

GET

/evaluations/:evaluator_id/

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

200Retrieved

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

Get, update, or delete an evaluator’s draft version.

GET /api/evaluators/{evaluator_id}/ - Get draft version (is_read_only=False) PATCH /api/evaluators/{evaluator_id}/ - Update draft version DELETE /api/evaluators/{evaluator_id}/ - Delete ALL versions

Superadmin: Can READ any evaluator across all organizations via JWT. Cannot WRITE via JWT - must use API key for write operations. Regular users: Can only access evaluators in their organization.

NOTE: Queryset filters by is_read_only=False, ensuring unique lookup per evaluator_id. This allows DRF’s standard get_object() to work without manual overrides. Delete removes ALL versions of the evaluator.

Defense-in-depth:

SuperAdminMixin: Queryset routing + JWT write protection + object-level ownership

Get, update, or delete an evaluator's draft version. GET /api/evaluators/{evaluator_id}/ - Get draft version (is_read_only=False) PATCH /api/evaluators/{evaluator_id}/ - Update draft version DELETE /api/evaluators/{evaluator_id}/ - Delete ALL versions Superadmin: Can READ any evaluator across all organizations via JWT. Cannot WRITE via JWT - must use API key for write operations. Regular users: Can only access evaluators in their organization. NOTE: Queryset filters by is_read_only=False, ensuring unique lookup per evaluator_id. This allows DRF's standard get_object() to work without manual overrides. Delete removes ALL versions of the evaluator. Defense-in-depth: - SuperAdminMixin: Queryset routing + JWT write protection + object-level ownership

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

evaluator_idstringRequired

Response

is_publicbooleanRead-only

created_byobject

updated_byobject

editorobject

namestring<=255 characters

created_atdatetimeRead-only

updated_atdatetimeRead-only

version_idstring<=255 characters

configurationsmap from strings to any

categorical_choiceslist of maps from strings to any

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

projectstring or null

eval_classstring

idstring<=255 characters

versioninteger-2147483648-2147483647

is_read_onlyboolean

version_descriptionstring

evaluator_slugstring<=255 characters

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

custom_required_fieldslist of strings

starredboolean