Delete evaluator versions

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": [
    "<string>"
  ]
}
'

import requests

url = "https://api.arize.com/v2/evaluators/{evaluator_id}/versions"

payload = { "version_ids": ["<string>"] }
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: ['<string>']})
};

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' => [
        '<string>'
    ]
  ]),
  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    \"<string>\"\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    \"<string>\"\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    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "completed": true,
  "deleted_version_ids": [
    "RXZhbHVhdG9yVmVyc2lvbjoxMDphQmNk",
    "RXZhbHVhdG9yVmVyc2lvbjoxMTphQmNk"
  ],
  "not_deleted_version_ids": []
}

Evaluators

Delete 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.

Payload Requirements

version_ids must 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. Check deleted_version_ids / not_deleted_version_ids for the outcome of each requested ID.
400 — malformed request: evaluator_id fails ID-format validation (Invalid evaluator ID format), or version_ids is 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_id does not exist or is not readable by the caller (Evaluator not found).
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"
}

This endpoint is in beta, read more here.

DELETE

evaluators

{evaluator_id}

versions

Delete evaluator versions

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": [
    "<string>"
  ]
}
'

import requests

url = "https://api.arize.com/v2/evaluators/{evaluator_id}/versions"

payload = { "version_ids": ["<string>"] }
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: ['<string>']})
};

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' => [
        '<string>'
    ]
  ]),
  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    \"<string>\"\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    \"<string>\"\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    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "completed": true,
  "deleted_version_ids": [
    "RXZhbHVhdG9yVmVyc2lvbjoxMDphQmNk",
    "RXZhbHVhdG9yVmVyc2lvbjoxMTphQmNk"
  ],
  "not_deleted_version_ids": []
}

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 unique evaluator identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Body

application/json

Body identifying the versions to delete from the evaluator named by the evaluator_id path parameter.

version_ids

string[]

required

IDs of the evaluator versions to delete (up to 100 per request). IDs that do not belong to evaluator_id are reported as not deleted. Duplicate IDs are accepted and silently collapsed so each version is processed at most once.

Required array length: 1 - 100 elements

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.

completed

boolean

required

Always true in a successful response, indicating both result lists are complete. This does not indicate whether all requested versions existed.

deleted_version_ids

string[]

required

Evaluator version IDs confirmed deleted in this request.

not_deleted_version_ids

string[]

required

Requested evaluator version IDs that were not deleted.

⌘I

Skills

API reference

API clients

Delete evaluator versions

Authorizations

Path Parameters

Body

Response