Throw a draft away

POST
/v1/drafts/{id}/discard

Throws away a draft or a held message. Nothing is sent and it cannot be brought back; write a new draft to try again.

Requires an API key with the messages:send 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 draft id.

Response Body

Thrown away; nothing was sent

application/json
  1. response
ok*boolean

Always true when the answer is a 200.

messageId*string
Formatuuid
Example Request
curl -X POST "https://api.vlayers.ai/v1/drafts/$DRAFT_ID/discard" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "ok": true,  "messageId": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"}