# Editando um Documento

Depois de ter criado o documento, você ainda pode editar algumas configurações dele, a *mutation* para atualização de documento é apresentada a seguir:

```graphql
mutation (
  $id: UUID!,
  $document: UpdateDocumentInput! 
) {
  updateDocument(id: $id, document: $document) {
    id
    name
    message
    reminder
    refusable
    sortable
    stop_on_rejected
    new_signature_style
    show_audit_page
    expiration_at
    deadline_at
    email_template_id
    footer
    cc
    configs {
      notification_finished
      notification_signed
      signature_appearance
    }
    created_at
   }
}
```

**Parâmetros:**

* `id`: String (UUID!) que representa o identificador único do documento que você deseja editar.
* `document`: Objeto(UpdateDocumentInput!) que contém os detalhes das propriedades que serão editadas no documento.

Após, ainda precisamos atribuir os valores das variáveis declaradas na *mutation*, em um JSON. Exemplo de valores para as variáveis da *mutation*:

```json
{
  "id": "ID_DO_DOCUMENTO",
  "document": {
      "name": "NOME_DOCUMENTO",
      "message": "Mensagem customizada enviada para os emails dos signatários",
      "reminder": "WEEKLY",
      "sortable": true, 
      "footer": "BOTTOM", 
      "refusable": true,
      "new_signature_style": true, 
      "show_audit_page": false, 
      "ignore_cpf": true, 
      "email_template_id": 1234, 
      "deadline_at": "2023-11-24T02:59:59.999Z",
      "cc": [
        { "email": "email-cc-1@tuamaeaquelaursa.com" },
        { "email": "email-cc-2@tuamaeaquelaursa.com" }
      ],
      "expiration": {
        "days_before": 7,
        "notify_at": "20/01/2026"
    }
  }
}
```

#### UpdateDocumentInput:

A tabela a seguir descreve os campos que podem ser incluídos no objeto `UpdateDocumentInput`.

<table><thead><tr><th width="218">Campo</th><th width="232.33333333333331">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>O novo nome para o seu documento</td></tr><tr><td>message</td><td>String</td><td>Uma mensagem personalizada que será enviada para os emails dos signatários.</td></tr><tr><td>reminder</td><td>'DAILY' | 'WEEKLY'</td><td>Define a frequência dos lembretes por email. </td></tr><tr><td>refusable</td><td>Boolean</td><td>Se true, permite que os signatários recusem assinar o documento.</td></tr><tr><td>ignore_cpf</td><td>Boolean</td><td>Remove obrigatoriedade de preencher CPF para assinar</td></tr><tr><td>stop_on_rejected</td><td>Boolean</td><td>Impede que outras pessoas assinem quando recusado</td></tr><tr><td>scrolling_required</td><td>Boolean</td><td>Apenas libera a assinatura caso o signatário tenha visualizado todas as páginas do documento</td></tr><tr><td>sortable</td><td>Boolean</td><td>Signatários assinam na ordem do array "signers"</td></tr><tr><td>new_signature_style</td><td>Boolean</td><td>Se true, ativa o uso de um estio de assinatura atualizado.</td></tr><tr><td>show_audit_page</td><td>Boolean</td><td><p>Evita criar a última página de auditoria.</p><p>Requer "new_signature_style": true</p></td></tr><tr><td>expiration</td><td><a data-mention href="#expirationinput">#expirationinput</a></td><td>Envia um lembrete de vencimento para os signatários.</td></tr><tr><td>footer</td><td>'BOTTOM' | 'LEFT' | 'RIGHT'</td><td>Define a posição do rodapé no documento.</td></tr><tr><td>cc</td><td>[ String! ]</td><td>Envia emails quando o documento for assinado por todos os signatários</td></tr><tr><td>configs</td><td><a data-mention href="#documentconfiginput">#documentconfiginput</a></td><td>Outras configurações do documento.</td></tr><tr><td>deadline_at</td><td>String</td><td><p>Data no formato ISO 8601, como "YYYY-MM-DDTHH:MM:SS.SSSZ"). </p><p>A data limite para a assinatura do documento.</p></td></tr></tbody></table>

#### ExpirationInput

Objeto dentro de `UpdateDocumentInput` que contém informações sobre a expiração do documento.

<table><thead><tr><th width="186">Campo</th><th width="94.33333333333331">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>days_before</td><td>Int!</td><td>Quantidade de dias antes do vencimento para enviar a notificação.</td></tr><tr><td>notify_at</td><td>Date!</td><td>Data de vencimento do documento.</td></tr></tbody></table>

#### DocumentConfigInput

Sub-objeto dentro de `UpdateDocumentInput` para configurações adicionais.

| Campo                  | Tipo                                              | Descrição                                                   |
| ---------------------- | ------------------------------------------------- | ----------------------------------------------------------- |
| notification\_finished | Boolean                                           | Ativa a notificação de conclusão do documento               |
| notification\_signed   | Boolean                                           | Enviar email ao signatário quando ele assinar               |
| signature\_appearance  | 'DRAW' \| 'HANDWRITING' \| 'ELETRONIC' \| 'IMAGE' | Força a aparência das assinaturas para a opção selecionada. |
| lock\_user\_data       | Boolean                                           | Mantém os dados do usuário desatualizados                   |

{% hint style="info" %}
Você pode conferir o que é cada um desses parâmetros direto na documentação completa da API GraphQL, no menu Docs do [Altair](https://altair.autentique.com.br). Se você não sabe como fazer isso, confira o nosso tutorial em [Usando o Altair](/api/2/integracao/altair.md).
{% endhint %}

{% hint style="info" %}
Se o Altair não te ajuda para integrar com a API, confira alguns exemplos de como fazer essas requisições de outra forma: <https://graphql.org/graphql-js/graphql-clients/>
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autentique.com.br/api/2/mutations/editando-um-documento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.