Skip to main content
DELETE /v1/agents/{agent_id}/versions
Deletes the version that has the label you send.
  • production returns 400. Move the label first.
  • A label with no version returns 404. A label on more than one version returns 400.
  • You cannot delete the only version.
  • If you delete the latest version, the label moves to the highest remaining version.
DELETE /v1/agents/{agent_id}/prompts/versions is the deprecated path of this endpoint.

Path parameters

Query parameters

Headers

Response

A 200 response has no body.

Status codes

Example request

Last modified on October 21, 2026