List drafts waiting to be sent
GET
The messages that have not left yet: sends a mailbox kept for approval, and drafts written on purpose. Oldest first, a page at a time. A key limited to one mailbox sees only that mailbox's drafts. A draft nobody sends or throws away within the review window (7 days by default) is thrown away, never sent.
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.
conversationId?stringOnly drafts that answer this conversation.
Format
uuidcursor?stringThe previous page's nextCursor.
Length
1 <= length <= 256limit?integerHow many items to return, 1–100. Default 50.
Range
1 <= value <= 100A page of the drafts waiting to be sent, oldest first
application/json- response
drafts*array<>nextCursor*string|nullcurl "https://api.vlayers.ai/v1/drafts?limit=20" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "drafts": [ { "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": "pending", "createdAt": "2026-10-20T15:04:05.000Z", "expiresAt": "2026-10-27T15:04:05.000Z", "decidedBy": null, "decidedAt": null, "edited": false, "reason": null } ], "nextCursor": null}