> ## Documentation Index
> Fetch the complete documentation index at: https://docs.manypi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merge or discard drafts

> merge turns drafts into leads (deduplicated like any import) in list_id, or in each form's own lists when omitted. discard closes them without a lead.

`POST /api/forms/drafts`, API key scope `write`. Also available as the `merge_form_drafts` MCP tool.

`merge` turns drafts into leads (deduplicated like any import) in `list_id`, or in each form's own lists when omitted. `discard` closes them without a lead. Pro and Business.

| Parameter | In | Description |
| - | - | - |
| `action` | body | merge or discard |
| `ids` | body | Draft ids (up to 500) |
| `list_id` | body | A lead list id (merge only, optional) |

## Example

```bash theme={null}
curl -X POST "https://app.manypi.com/api/forms/drafts" \
  -H "Authorization: Bearer $MANYPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "merge", "ids": ["…"], "list_id": "…" }'
```

## Response

```json theme={null}
{ "merged": 1, "skipped": [], "leadIds": ["…"] }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.