Send a draft you wrote

POST
/v1/drafts/{id}/send

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.

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.

Request Body

application/json
  1. body
body?string

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

Length1 <= length <= 20000

Response Body

Sent: the draft is now the 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/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"}