> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/security-compliance/document-custody/upload-document.md).

# Enviar documento

Serviço para carregar um documento PDF usando a URL de upload pré-assinada obtida do Endpoint `/services/custody/upload`.

A URL de upload é válida por **5 minutos** a partir de sua geração.

{% hint style="info" %}
Use a URL de upload completa retornada pelo Endpoint anterior, não este caminho diretamente.
{% endhint %}

### Endpoint

```
PUT /custody/upload/{uploadToken}
```

### Parâmetros de rota

| Parâmetro     | Tipo   | Obrigatório | Descrição                            |
| ------------- | ------ | ----------- | ------------------------------------ |
| `uploadToken` | string | **Sim**     | Token de upload da URL pré-assinada. |

### Corpo da solicitação

**Content-Type:** `multipart/form-data`

#### Parâmetros

| Parâmetro | Tipo   | Obrigatório | Descrição                 |
| --------- | ------ | ----------- | ------------------------- |
| `file`    | binary | **Sim**     | Arquivo de documento PDF. |

### Respostas

#### `200` Sucesso

O documento foi carregado com sucesso.

#### `400` Bad Request

```json
{
  "status": 400,
  "title": "Requisição inválida",
  "detail": "Solicitação inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": [
    "Formato de arquivo inválido. Somente PDF é suportado."
  ]
}
```

#### `401` Não autorizado

```json
{
  "message": "Não autorizado"
}
```

#### `403` Proibido

```json
{
  "Message": "O usuário não está autorizado a acessar este recurso com uma negação explícita"
}
```

#### `413` Carga útil muito grande

```json
{
  "status": 413,
  "title": "Carga útil muito grande",
  "detail": "O tamanho do arquivo excede o limite.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/413",
  "errors": []
}
```

#### `502` Bad Gateway

```json
{
  "status": 502,
  "title": "Gateway inválido",
  "detail": "O servidor recebeu uma resposta inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}
```

#### `504` Gateway Timeout

```json
{
  "message": "A requisição do Endpoint excedeu o tempo limite"
}
```