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"
}

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