Send a draft you wrote
POST
Sends a draft now, as written or with new words in body. It goes through the same checks as any send (text screening, the recipient rule, opt-outs, limits) and is charged like one; a refusal says why and leaves the draft waiting so you can fix it. Anyone holding the send permission for the mailbox may send it, and the draft records who did.
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 draft id.
application/json- body
body?stringNew words to send instead of the draft's. Leave out to send it as written.
Length
1 <= length <= 20000Sent: the draft is now the 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/send" \ -H "Authorization: Bearer $VOICELAYER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "body": "Friday at 4pm works better for us." }'Example Response
{ "ok": true, "messageId": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"}