List drafts waiting to be sent

GET
/v1/drafts

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.

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.

Query Parameters

conversationId?string

Only drafts that answer this conversation.

Formatuuid
cursor?string

The previous page's nextCursor.

Length1 <= length <= 256
limit?integer

How many items to return, 1–100. Default 50.

Range1 <= value <= 100

Response Body

A page of the drafts waiting to be sent, oldest first

application/json
  1. response
drafts*array<>
nextCursor*string|null
Example Request
curl "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}