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.

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).
• 409 — the request would delete every remaining version of an evaluator that an online task still uses.
• 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"
}

<Note>This endpoint is in beta, read more here.</Note>