---
title: "Delete Document Recipient"
method: DELETE
path: "/public/v1/documents/{id}/recipients/{recipient_id}"
tags: ["Document Recipients"]
---

# Delete Document Recipient

`DELETE /public/v1/documents/{id}/recipients/{recipient_id}`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/documents/{id}/recipients/{recipient_id}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v1/documents/:id/recipients/:recipient_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Remove a recipient from a document.

> 🚧 Before you start
> 
> Please ensure that you have the 'Can Manage Recipients' permission.

To remove a recipient from a document, you must specify their ID in the path parameter (note that this is different from their contact's ID). The recipient's ID can be retrieved via the [Document Details](https://developers.pandadoc.com/reference/document-details) endpoint.

### Document status

- Removing a signer is only possible when the document is in the 'Draft' (`document.draft`) status and this action will unassign all fields associated with that signer.
- Removing a CC recipient is allowed in any document status except for the 'Expired' (`document.voided`) and 'Declined' (`document.declined`). If a CC recipient is removed, their access will be revoked.

## Path parameters

- `id` string, required
- `recipient_id` string, required

## Response `204`

No content

## Other responses

- `401`: Authentication error
- `403`: Permission error
- `404`: Not found
- `423`: Document is locked for editing
- `429`: Too Many Requests

---

[API](https://skmtc.dev/pandadoc/apis/pandadoc-public-api.md) - [All operations](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/revisions/b9a306b1a421?raw)