Skip to main content
POST
/
v2
/
evaluators
/
{evaluator_id}
/
versions
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",
  "type": "template",
  "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="
}

Documentation Index

Fetch the complete documentation index at: https://arize-ax.mintlify.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

Payload for an evaluator version: exactly one of template_config or code_config. Used both when creating an evaluator (initial version) and when appending a version.

​
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. Exactly one of template_config or code_config is present. The type field discriminates the branch and matches the parent evaluator's type.

​
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

​
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

​
type
enum<string>
required

Evaluator version type. Must be template for template evaluator versions; must match the parent evaluator's type.

Available options:
template
​
template_config
object
required

The LLM template configuration for this version