Agent Versions
DELETE /v1/agents/{agent_id}/versions
Delete an agent version by label.
DELETE /v1/agents/{agent_id}/versions
Deletes the version that has the
label you send.
productionreturns 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
latestversion, 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
A200 response has no body.
Status codes
Example request
Last modified on October 21, 2026