Delete a hosted version

DELETE
/v1/agents/{id}/versions/{version}

Deletes a version that carries an image. The version live calls run cannot be deleted: publish another first. When the last version that names an image is deleted, the image is removed from the registry and from the servers that cached it; the record that it existed stays.

Requires an API key with the workspace:write scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The agent id.

version*string

The version number, as the agent numbers its versions (1, 2, 3, …).

Response Body

The version is deleted

application/json
  1. response
deleted*boolean
version*integer
Range1 <= value
digest*|
Match^sha256:[0-9a-f]{64}$
imageDeleted*boolean
Example Request
curl -X DELETE "https://api.vlayers.ai/v1/agents/$AGENT_ID/versions/$VERSION" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "deleted": true,  "version": 2,  "digest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",  "imageDeleted": true}