Approve a message held for review

POST
/v1/drafts/{id}/approve

Sends a message that a mailbox kept for approval (the mailbox is set to ask before sending), as written or with new words in body. The same decision as sending a draft: the checks and the charge are the same, and the message records who approved it. Anyone holding the send permission for the mailbox may approve.

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 held message id.

Request Body

application/json
  1. body
body?string

New words to send instead of the held message's. Leave out to send it as written.

Length1 <= length <= 20000

Response Body

Approved and sent: the held message is now the sent message

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/approve" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "body": "Approved. Friday at 4pm works better for us."  }'
Example Response
{  "ok": true,  "messageId": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"}