Delete Version
Agents
Delete a version
Remove a draft or an old published version.
Delete Version
204, no body.
Numbers are allocated max + 1 across drafts and published versions alike, so gaps are normal —
a discarded draft leaves its number spent. The one case where a number comes back is deleting the
highest version: delete V4 when V4 is the newest and the next draft is V4 again. If you record
version numbers on your side, record them against the agent’s state at the time, not as permanent
identifiers.Authorizations
Your API key as a Bearer token, e.g. Authorization: Bearer vk_….
Path Parameters
The agent's id, as GET /v1/agents returns it.
A version number (0, 1, 3) or a version uuid — both resolve. Prefer the number: it is the version's identity to you, it is what every version read returns, and it needs no lookup first.
Response
Successful Response