Delete a version
Delete a draft. Deleting a version that is already gone succeeds, because that is the state you asked for, so retrying a delete is safe.
Deleting one whose AGENT is gone does not: the agent is read first, so that answers 404. Both are idempotent, but only the first is a 204 — worth knowing if you retry a delete after deleting the agent, which takes its versions with it anyway.
The published version cannot be deleted. Publish a different version first.
Authorization
bearerAuth A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.
In: header
Path Parameters
The agent's unique ID.
The version number: <major>.<minor>, two non-negative integers with no leading zeros and at most nine digits each — 0.1, 1.0, 2.13. You choose it. Anything else is rejected with invalid_version, because the number is part of the version's storage key.
^(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})$Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/agent-media/agents/string/versions/string"{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}