Read a draft

GET
/v1/drafts/{id}

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.

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.

Response Body

The draft, whether waiting, sent or thrown away

application/json
  1. response
draft*
Example Request
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  }}