Delete a hosted version
DELETE
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.
apiKeyheader
AuthorizationBearer <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.
id*stringThe agent id.
version*stringThe version number, as the agent numbers its versions (1, 2, 3, …).
The version is deleted
application/json- response
deleted*booleanversion*integerRange
1 <= valuedigest*|Match
^sha256:[0-9a-f]{64}$imageDeleted*booleancurl -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}