# List drafts waiting to be sent

Source: https://docs.vlayers.ai/reference/messages/list-drafts

`GET /v1/drafts` · scope `messages:read`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `conversationId` | query | string | no | Only drafts that answer this conversation. Example: `"0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21"` |
| `cursor` | query | string | no | The previous page's `nextCursor`. Example: `"eyJ1IjoiMjAyNi0xMC0yMFQxNTowNDowNVoifQ"` |
| `limit` | query | integer | no | How many items to return, 1–100. Default 50. Example: `20` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/drafts?limit=20" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { drafts } = await voicelayer.messages.listDrafts({ limit: 20 });
console.log(drafts);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.messages.list_drafts(limit=20)
print(result.drafts)
```

## Response `200`

```json
{
  "drafts": [
    {
      "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",
      "conversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",
      "mailbox": "support@acme.vlayersmail.com",
      "to": "ada@example.org",
      "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
}
```
