# Reject documents by User

<mark style="color:green;">`POST`</mark>`https://api.zapsign.com.br/api/v1/refuse/by-user/`

**How to Use:**

Send a payload in JSON format with the following fields:

* **doc\_token:** (string) Token of the document to be rejected.
* **user\_token:** (string) Token of the user rejecting the document.
* **signer\_token:** (string) Token of the signer related to the document.
* **rejected\_reason:** (string, optional) Reason for rejecting the document.

Learn more about the[ types of tokens here](https://docs.zapsign.com.br/english/types-of-tokens)

**Conditions:**

* The document must have the status “In progress.”
* When creating the document, the parameter `allow_refuse_signature` must be set to true.

**Notes:**

* When a document is refused, it receives the watermark "Document refused" and cannot be signed in the future.
* The endpoint response will also be returned in JSON format.
* This endpoint is asynchronous and may take a few seconds to update the document's final status.

**Headers:**

<table><thead><tr><th width="165">Name</th><th width="111">Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>API token prefixed by the text "Bearer". Example: <code>Bearer c7f35c84-7893-4087-b4fb-d1f06c23</code>.</td></tr></tbody></table>

#### Request Body

| Name                                            | Type   | Description          |
| ----------------------------------------------- | ------ | -------------------- |
| doc\_token<mark style="color:red;">\*</mark>    | string | Document token       |
| user\_token<mark style="color:red;">\*</mark>   | string | User token           |
| signer\_token<mark style="color:red;">\*</mark> | string | Signer token         |
| rejected\_reason                                | string | Reason for rejection |

Request example

```json
{
    "doc_token":"e082d806-6b31-4e27-ae9a-e16b603a70b3",
    "user_token":"97ab0000-36d4-xxxx-9ded-00005d690xxxx",
    "signer_token": "8be272d8-20a9-xx-899c-db4edbb846cd",
    "rejected_reason": ""
}
```

Response

{% tabs %}
{% tab title="200 - " %}

```json
{
    "message": "Document successfully refused. Please note: this endpoint is asynchronous, so wait for the final PDFs to be ready via webhooks or check them in a few minutes."
}
```

{% endtab %}

{% tab title="403" %}

```json
{
    "error": "Refusing this document is not allowed."
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "error": "The signer's email and the user's email are different."
}
```

{% endtab %}
{% endtabs %}