> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/mutations/assinando-um-documento.md).

# Assinando um Documento

Como assinar um documento.

Depois de criar um documento, você pode assiná-lo utilizando a mutation `signDocument`.

A assinatura será realizada em nome do titular da chave de API utilizada na requisição. Isso significa que essa mutation não deve ser usada para assinar o documento em nome de outras pessoas.

```graphql
mutation SignDocument(
  $documentId: UUID!
  $organizationId: Int
) {
  signDocument(
    id: $documentId
    organization_id: $organizationId
  )
}
```

Variáveis:

```json
{
  "documentId": "UUID_DO_DOCUMENTO",
  "organizationId": null
}
```

Caso a operação seja realizada no contexto de uma organização, envie seu identificador:

```json
{
  "documentId": "UUID_DO_DOCUMENTO",
  "organizationId": 123
}
```

<table><thead><tr><th width="157.00390625">Parâmetro</th><th width="91.921875">Tipo</th><th width="134.69921875">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>UUID!</code></td><td>Sim</td><td>UUID do documento que será assinado.</td></tr><tr><td><code>organization_id</code></td><td><code>Int</code></td><td>Não</td><td>Identificador da organização relacionada à assinatura. O valor padrão é <code>null</code>.</td></tr></tbody></table>

#### Retorno

A mutation retorna um valor do tipo `Boolean`:

```json
{
  "data": {
    "signDocument": true
  }
}
```

O valor `true` indica que a assinatura foi concluída.

#### Antes de assinar

A conta vinculada à chave de API precisa estar incluída entre os signatários do documento. Caso contrário, a API retornará o erro `signature_not_found`.

Também não é possível utilizar essa mutation para permitir que outros signatários assinem diretamente dentro da sua aplicação. Ela assina exclusivamente com a conta do titular da chave de API. Para coletar assinaturas de outras pessoas, utilize o fluxo de solicitação ou link de assinatura.

***

Você pode testar a assinatura no [Altair](https://altair.autentique.com.br):

![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-LzJ8dX5-cVLAGSwwWf3%2F-LzJAxLV4DWgcd1jaEcO%2Fimage.png?alt=media\&token=2e6764d6-57e9-434a-8dd0-fa40e1115ff9)

{% 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 %}

{% file src="/files/-M03o9cE5QB3vLoPUlzJ" %}
Para importar e usar no Postman
{% endfile %}