Skip to main content
Delete Version
204, no body.
Two versions cannot be deleted, and both answer 409 rather than failing silently:
  • The live one. Take the agent off air with DELETE /v1/agents/{agent_id}/live first, or make a different version live — deleting the version answering your calls would drop them.
  • One an unfinished batch is pinned to. A running batch holds the exact configuration it started with, so the version outlives the delete until the batch finishes.
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

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Path Parameters

agent_id
string
required

The agent's id, as GET /v1/agents returns it.

version_id
string
required

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