Skip to main content
POST
/
v2
/
evaluators
/
{evaluator_id}
/
versions
Create evaluator version
curl --request POST \
  --url https://api.arize.com/v2/evaluators/{evaluator_id}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "commit_message": "Improve template wording",
  "template_config": {
    "name": "hallucination",
    "template": "Evaluate whether the output is factually grounded.\n\nInput: {{input}}\nOutput: {{output}}",
    "include_explanations": true,
    "use_function_calling_if_available": true,
    "classification_choices": {
      "hallucinated": 0,
      "factual": 1
    },
    "direction": "maximize",
    "data_granularity": "span",
    "llm_config": {
      "ai_integration_id": "TGxtSW50ZWdyYXRpb246MTI6YUJjRA==",
      "model_name": "gpt-4o",
      "invocation_parameters": {
        "temperature": 0
      },
      "provider_parameters": {}
    }
  }
}
'
{
  "id": "RXZhbHVhdG9yVmVyc2lvbjoxMTpBYkNk",
  "evaluator_id": "RXZhbHVhdG9yOjEyOmFCY0Q=",
  "commit_hash": "b4c2d0e5f8a3b1629f7d4cc0328g98e2d5f921g3",
  "commit_message": "Improve template wording",
  "template_config": {
    "name": "hallucination",
    "template": "Evaluate whether the output is factually grounded...",
    "include_explanations": true,
    "use_function_calling_if_available": true,
    "classification_choices": {
      "hallucinated": 0,
      "factual": 1
    },
    "direction": "maximize",
    "data_granularity": "span",
    "llm_config": {
      "ai_integration_id": "TGxtSW50ZWdyYXRpb246MTI6YUJjRA==",
      "model_name": "gpt-4o",
      "invocation_parameters": {
        "temperature": 0
      },
      "provider_parameters": {}
    }
  },
  "created_at": "2026-02-17T10:30:00.000Z",
  "created_by_user_id": "VXNlcjoxOm5OYkM="
}

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

evaluator_id
string
required

The evaluator global ID (base64) A universally unique identifier

Example:

"RW50aXR5OjEyMzQ1"

Body

application/json

Body containing evaluator version creation parameters

commit_message
string
required

Commit message describing the changes

template_config
object
required

The template configuration for this version

Response

Returns the created evaluator version

A versioned snapshot of an evaluator's configuration.

id
string
required

The unique identifier for this version

evaluator_id
string
required

The parent evaluator ID

commit_hash
string
required

A unique hash identifying this version

commit_message
string | null
required

A message describing the changes in this version

template_config
object
required

The template configuration for this version

created_at
string<date-time>
required

When this version was created

created_by_user_id
string | null
required

The unique identifier for the user who created this version