# Throw a draft away

Source: https://docs.vlayers.ai/reference/messages/discard-draft

`POST /v1/drafts/{id}/discard` · scope `messages:send`

Throws away a draft or a held message. Nothing is sent and it cannot be brought back; write a new draft to try again.

Requires an API key with the `messages:send` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The draft id. Example: `"0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"` |

## Request

cURL:

```bash
curl -X POST "https://api.vlayers.ai/v1/drafts/$DRAFT_ID/discard" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { messageId } = await voicelayer.messages.discardDraft('<draft-id>');
console.log(messageId);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.messages.discard_draft("<draft-id>")
print(result.message_id)
```

## Response `200`

```json
{
  "ok": true,
  "messageId": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"
}
```
