Partial Update

PATCH

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

PATCH

/evaluations/

$ curl -X PATCH https://api.respan.ai/evaluations/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Updated

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

PATCH handler with superadmin lock and field protection.

Checks:

Object lock (is_managed=True -> non-superadmins can’t modify)
Field protection (non-superadmins can’t modify specific fields)

Authentication

AuthorizationBearer

JWT access token or Respan API key

Request

This endpoint expects an object.

version_idstringOptional1-255 characters

configurationsmap from strings to anyOptional

categorical_choiceslist of maps from strings to anyOptional

score_configmap from strings to anyOptional

passing_conditionsmap from strings to any or nullOptional

llm_configmap from strings to any or nullOptional

code_configmap from strings to any or nullOptional

projectstring or nullOptional>=1 character

eval_classstringOptional>=1 character

idstringOptional1-255 characters

versionintegerOptional-2147483648-2147483647

is_read_onlybooleanOptional

version_descriptionstringOptional

evaluator_slugstringOptional<=255 characters

namestringOptional1-255 characters

unique_organization_idstring or nullOptional<=255 characters

descriptionstringOptional

typeenumOptional

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_typeenumOptional

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 stringsOptional

starredbooleanOptional

organizationinteger or nullOptional

Response

is_publicbooleanRead-only

namestring<=255 characters

created_atdatetimeRead-only

updated_atdatetimeRead-only

created_byinteger or nullRead-only

updated_byinteger or nullRead-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