# List drafts

### List drafts

`GET /api/v1/drafts`

Operation ID: `listDrafts`

Messages drafted for the workspace that wait for a person to review them before they send. Review them in the Needle inbox.

**Query parameters**

- `cursor` (string, optional)
- `limit` (integer, optional)
- `campaignId` (string · uuid, optional): Only drafts from this campaign

**200**: A page of drafts, newest first. Pass nextCursor as cursor for the next page.

- `drafts` (object[], required)
- `nextCursor` (string | null, required)
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload
