---
title: "Changes to Create evaluator version"
method: POST
path: "/v2/evaluators/{evaluator_id}/versions"
---

# Changes to Create evaluator version

`POST /v2/evaluators/{evaluator_id}/versions`

> Every recorded change to this endpoint, newest first.
> 16 revisions in range; 1 not diffed.

## Timeline

Changed in 4 of 16 revisions.

- **2026-08-27** `9263b98aaefb` — 1 info
- **2026-08-21** `c26a00e9b318` — 2 breaking, 1 warning, 1 info
- **2026-08-10** `4d95080d8ffb` — 1 breaking, 1 warning
- **2026-08-07** `1e87d8a4cf69` — 5 breaking, 4 warning, 5 info

## Changes

- **2026-08-27** `9263b98aaefb` — 1 info
  - added the optional property `oneOf[#/components/schemas/EvaluatorVersionTemplate]/allOf[subschema #2]/template_config/llm_config/invocation_parameters/service_tier` to the response with the `201` status
- **2026-08-21** `c26a00e9b318` — 2 breaking, 1 warning, 1 info
  - added the new required request property `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/use_function_calling`
  - removed the required property `oneOf[#/components/schemas/EvaluatorVersionTemplate]/allOf[subschema #2]/template_config/use_function_calling_if_available` from the response with the `201` status
  - removed the request property `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/use_function_calling_if_available`
  - added the optional property `oneOf[#/components/schemas/EvaluatorVersionTemplate]/allOf[subschema #2]/template_config/use_function_calling` to the response with the `201` status
- **2026-08-10** `4d95080d8ffb` — 1 breaking, 1 warning
  - added `#/components/schemas/ToolConfigRequest` to the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/invocation_parameters/tool_config` request property `allOf` list
  - removed `#/components/schemas/ToolConfig` from the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/invocation_parameters/tool_config` request property `allOf` list
- **2026-08-07** `1e87d8a4cf69` — 5 breaking, 4 warning, 5 info
  - added `#/components/schemas/AnthropicHeadersRequest` to the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/provider_parameters/anthropic_headers` request property `allOf` list
  - added `#/components/schemas/AzureParamsRequest` to the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/provider_parameters/azure_params` request property `allOf` list
  - added `#/components/schemas/BedrockOptionsRequest` to the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/provider_parameters/bedrock_options` request property `allOf` list
  - added `#/components/schemas/ResponseFormatRequest` to the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/invocation_parameters/response_format` request property `allOf` list
  - removed `#/components/schemas/ManagedCodeConfig, #/components/schemas/CustomCodeConfig` from the `oneOf[#/components/schemas/CreateCodeEvaluatorVersionRequest]/code_config` request property `oneOf` list
  - removed `#/components/schemas/AnthropicHeaders` from the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/provider_parameters/anthropic_headers` request property `allOf` list
  - removed `#/components/schemas/AzureParams` from the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/provider_parameters/azure_params` request property `allOf` list
  - removed `#/components/schemas/BedrockOptions` from the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/provider_parameters/bedrock_options` request property `allOf` list
  - removed `#/components/schemas/ResponseFormat` from the `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/llm_config/invocation_parameters/response_format` request property `allOf` list
  - the request property `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/classification_choices` became nullable
  - the request property `oneOf[#/components/schemas/CreateTemplateEvaluatorVersionRequest]/template_config/classification_choices` became optional
  - mapped value for discriminator key `CUSTOM` changed from `#/components/schemas/CustomCodeConfig` to `#/components/schemas/CustomCodeConfigRequest` for `oneOf[#/components/schemas/CreateCodeEvaluatorVersionRequest]/code_config` request property
  - mapped value for discriminator key `MANAGED` changed from `#/components/schemas/ManagedCodeConfig` to `#/components/schemas/ManagedCodeConfigRequest` for `oneOf[#/components/schemas/CreateCodeEvaluatorVersionRequest]/code_config` request property
  - added `#/components/schemas/ManagedCodeConfigRequest, #/components/schemas/CustomCodeConfigRequest` to the `oneOf[#/components/schemas/CreateCodeEvaluatorVersionRequest]/code_config` request property `oneOf` list

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-rest-api/docs/v2/evaluators/:evaluator_id/versions/post.md) · [API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) · [Page](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/evaluators/:evaluator_id/versions/post)