Read a draft
GET
One draft, in any state: waiting, sent or thrown away. A sent or discarded draft says who decided it (decidedBy), when, and whether the words were changed.
Requires an API key with the messages:read 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.
The draft, whether waiting, sent or thrown away
application/json- response
draft*curl "https://api.vlayers.ai/v1/drafts/$DRAFT_ID" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "draft": { "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32", "conversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21", "mailbox": "[email protected]", "to": "[email protected]", "subject": "Friday", "body": "Friday at 3pm works. Shall I send an invite?", "attachments": [], "heldFor": "api", "origin": "composed", "state": "sent", "createdAt": "2026-10-20T15:04:05.000Z", "expiresAt": "2026-10-27T15:04:05.000Z", "decidedBy": "key:0192f5c4-8b9c-7dbe-8f3a-4b5c6d7e8f90", "decidedAt": "2026-10-20T15:04:05.000Z", "edited": false, "reason": null }}