Update an evaluator | Respan Docs

curl -X PATCH https://api.respan.ai/api/evaluators/evaluator_id/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "0f4325f9-55ef-4c20-8abe-376694419947",
  "name": "Enhanced Response Quality Evaluator",
  "evaluator_slug": "response_quality_v1",
  "type": "llm",
  "score_value_type": "numerical",
  "eval_class": "",
  "description": "Advanced evaluator for response quality assessment with updated criteria",
  "configurations": {
    "evaluator_definition": "Rate the response quality based on accuracy, relevance, and completeness.\n<llm_input>{{llm_input}}</llm_input>\n<llm_output>{{llm_output}}</llm_output>",
    "scoring_rubric": "Updated: 1=Very Poor, 2=Poor, 3=Fair, 4=Good, 5=Excellent",
    "llm_engine": "gpt-4o",
    "model_options": {
      "temperature": 0.2,
      "max_tokens": 300
    },
    "min_score": 1,
    "max_score": 5,
    "passing_score": 4
  },
  "created_by": {
    "first_name": "Respan",
    "last_name": "Team",
    "email": "admin@respan.ai"
  },
  "updated_by": {
    "first_name": "Respan",
    "last_name": "Team",
    "email": "admin@respan.ai"
  },
  "created_at": "2025-09-11T09:43:55.858321Z",
  "updated_at": "2025-09-11T10:15:22.123456Z",
  "custom_required_fields": [],
  "starred": true,
  "organization": 2,
  "tags": [
    "quality",
    "assessment",
    "production"
  ]
}

Update an evaluator's configuration, scoring, or automation settings.

Path parameters

evaluator_idstringRequired

Evaluator Id

Request

This endpoint expects an object.

namestringOptional

Evaluator name.

descriptionstringOptional

score_value_typeenumOptional

categorical_choiceslist of objectsOptional

score_configobjectOptional

Score configuration.

passing_conditionsobjectOptional

Passing conditions.

llm_configobjectOptional

LLM automation config.

code_configobjectOptional

Code automation config.

configurationsobjectOptional

Legacy config format.

Response

Successful response for Update evaluator

idstring

namestring

evaluator_slugstring

typestring

score_value_typestring

eval_classstring

descriptionstring

configurationsobject

created_byobject

updated_byobject

created_atstring

updated_atstring

custom_required_fieldslist of strings

categorical_choiceslist of objects or null

starredboolean

organizationinteger

tagslist of strings

Errors

401

Unauthorized Error

Path parameters

Headers

Request

Response

Errors