> For the complete documentation index, see [llms.txt](https://docs.zapsign.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapsign.com.br/zapsign-api/english/reset-signer-attempts.md).

# Reset validation attempts

If a signer fails the validation process three times, the document will be blocked and the signer will not be able to continue signing. This endpoint allows you to reset the validation attempts for a specific signer, enabling them to restart the validation process.

{% hint style="warning" %}
**Important:** When resetting the attempts, if the signer starts the validation process again, there will be an additional credit cost according to the selected method (see pricing here). The signer will have three (3) new attempts to validate their identity, and if they fail again, the process will be blocked once more.
{% endhint %}

<mark style="color:blue;">**PUT**</mark> `https://api.zapsign.com.br/api/v1/reset-auth-attempts/{{signer_token}}/`

#### Headers

<table><thead><tr><th width="137">Name</th><th width="90">Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td><p>apiToken ahead of the "Bearer" text. </p><p>Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</p></td></tr></tbody></table>

#### Params

<table><thead><tr><th width="137">Name</th><th width="90">Type</th><th>Description</th></tr></thead><tbody><tr><td>signer_token<mark style="color:red;">*</mark></td><td>string</td><td>Unique token of the signer (obtained when creating the document).</td></tr></tbody></table>

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

```json
{
    "success": "The signer's attempts have been successfully reset."
}
```

{% endtab %}

{% tab title="400 - Error" %}

```json
{
    "error": "Signer has attempts"
}
```

{% endtab %}
{% endtabs %}

### **Important Note**

This endpoint to reset attempts only applies to authentication methods that include retries, specifically when the `selfie_validation_type` parameter matches one of the following values:

* `liveness-document-match`
* `identity-verification`
* `identity-verification-global`

For other authentication methods that do not require selfie capture or biometric validation, this endpoint has no effect.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.zapsign.com.br/zapsign-api/english/reset-signer-attempts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.