Approve a message held for review
POST
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.
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 held message id.
application/json- body
body?stringNew words to send instead of the held message's. Leave out to send it as written.
Length
1 <= length <= 20000Approved and sent: the held message is now the sent message
application/json- response
ok*booleanAlways true when the answer is a 200.
messageId*stringFormat
uuidcurl -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"}