curl --request DELETE \
--url https://api.arize.com/v2/evaluators/{evaluator_id}/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"version_ids": [
"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE",
"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE"
]
}
'import requests
url = "https://api.arize.com/v2/evaluators/{evaluator_id}/versions"
payload = { "version_ids": ["RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE", "RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
version_ids: ['RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE', 'RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE']
})
};
fetch('https://api.arize.com/v2/evaluators/{evaluator_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.arize.com/v2/evaluators/{evaluator_id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'version_ids' => [
'RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE',
'RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.arize.com/v2/evaluators/{evaluator_id}/versions"
payload := strings.NewReader("{\n \"version_ids\": [\n \"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE\",\n \"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE\"\n ]\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.arize.com/v2/evaluators/{evaluator_id}/versions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"version_ids\": [\n \"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE\",\n \"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/evaluators/{evaluator_id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"version_ids\": [\n \"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE\",\n \"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE\"\n ]\n}"
response = http.request(request)
puts response.read_bodyDelete evaluator versions
Endpoint: DELETE /v2/evaluators/{evaluator_id}/versions
Deletes a batch of versions belonging to the evaluator identified by the
evaluator_id path parameter. This operation is irreversible.
The delete is partial-tolerant: versions that exist and belong to
evaluator_id are deleted; every requested ID that was not deleted is
reported back in not_deleted_version_ids (for example, because a version
was not found or belongs to a different evaluator). This is not an error —
the response is still 200.
Deleting a version currently pinned to a running online task un-pins that task; it falls back to resolving the evaluator’s latest version.
A request that would delete every remaining version of an evaluator that
an online task still uses returns 409, and no versions are deleted. The
error lists the tasks that use the evaluator. Keep at least one version,
or remove the evaluator from these tasks or delete the tasks first.
A request that would delete every remaining version of a
DECISION_JUDGE evaluator also returns 409, and no versions are
deleted. Delete the evaluator instead.
Payload Requirements
version_idsmust contain between 1 and 100 IDs. Duplicate IDs are accepted and silently collapsed so each version is processed at most once.
Responses
200— request processed. Checkdeleted_version_ids/not_deleted_version_idsfor the outcome of each requested ID.400— malformed request:evaluator_idfails ID-format validation (Invalid evaluator ID format), orversion_idsis missing/empty (version_ids must contain at least one evaluator version ID), not an array (version_ids must be an array), exceeds 100 entries (version_ids cannot contain more than 100 evaluator version IDs), or one entry fails ID-format validation (Invalid evaluator version ID format).401— missing or invalid credentials.403— the evaluator is readable but the caller lacks permission to delete its versions.404—evaluator_iddoes not exist or is not readable by the caller (Evaluator not found).409— the request would delete every remaining version of an evaluator that an online task still uses, or of aDECISION_JUDGEevaluator.429— rate limit exceeded.
Valid example — evaluator RXZhbHVhdG9yOjEyOkI3cmk= with a single
version RXZhbHVhdG9yVmVyc2lvbjozMjpBQ0Q2:
{
"version_ids": ["RXZhbHVhdG9yVmVyc2lvbjozMjpBQ0Q2"]
}
Response 200:
{
"completed": true,
"deleted_version_ids": ["RXZhbHVhdG9yVmVyc2lvbjozMjpBQ0Q2"],
"not_deleted_version_ids": []
}
Invalid example (empty version_ids)
{
"version_ids": []
}
Response 400:
{
"status": 400,
"title": "Bad Request",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request",
"detail": "version_ids must contain at least one evaluator version ID"
}
curl --request DELETE \
--url https://api.arize.com/v2/evaluators/{evaluator_id}/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"version_ids": [
"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE",
"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE"
]
}
'import requests
url = "https://api.arize.com/v2/evaluators/{evaluator_id}/versions"
payload = { "version_ids": ["RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE", "RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
version_ids: ['RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE', 'RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE']
})
};
fetch('https://api.arize.com/v2/evaluators/{evaluator_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.arize.com/v2/evaluators/{evaluator_id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'version_ids' => [
'RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE',
'RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.arize.com/v2/evaluators/{evaluator_id}/versions"
payload := strings.NewReader("{\n \"version_ids\": [\n \"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE\",\n \"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE\"\n ]\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.arize.com/v2/evaluators/{evaluator_id}/versions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"version_ids\": [\n \"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE\",\n \"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/evaluators/{evaluator_id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"version_ids\": [\n \"RXZhbHVhdG9yVmVyc2lvbjo5NzphQmNE\",\n \"RXZhbHVhdG9yVmVyc2lvbjo5ODphQmNE\"\n ]\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Service accounts may instead present an access token issued by an external identity provider (Microsoft Entra ID) when the account admin has configured that provider. Send it in the same header: Authorization: Bearer <access-token>.
Path Parameters
Body
Body identifying the versions to delete from the evaluator named by the
evaluator_id path parameter.
Response
Evaluator versions processed. A successful response includes completed: true
because both result lists are complete. This does not indicate whether every
requested version existed or was deleted. The delete is idempotent.
Result of a DELETE /v2/evaluators/{evaluator_id}/versions request.
The delete is partial-tolerant: requested versions that exist and belong to
evaluator_id are deleted; every requested ID that was not deleted is reported
in not_deleted_version_ids. An ID may be not-deleted because it does not exist
or belongs to a different evaluator.
completed is true when this response is returned because the synchronous
delete has fully processed the request. It does not mean every requested
version was found and deleted: each requested ID appears in exactly one of
deleted_version_ids or not_deleted_version_ids.
The delete operation is idempotent — re-submitting already-deleted IDs is safe and simply reports them as not deleted.
Deleting a version that is currently pinned to a running online task un-pins that task, which then falls back to resolving the evaluator's latest version.
Was this page helpful?