# Criar documento

Este endpoint cria um novo documento, opcionalmente com arquivo, com os dados fornecidos.

Source: https://zild.ai/pt-BR/docs/api-reference/post-api-Document

POST `/Document`

Este endpoint cria um novo documento, opcionalmente com arquivo, com os dados fornecidos.

## Autenticação

**Autenticação obrigatória.** Envie sua chave de API de usuário no header X-API-Key.

## Parâmetros

Esta operação não possui parâmetros de rota, query ou header.

## Corpo da requisição

**Content type:** `multipart/form-data` · **Schema:** `object`



<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>file</code></td><td><code>string · binary</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>Id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>Title</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>Description</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>FileUrl</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>DocumentStatusId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>DocumentType</code></td><td><code>DocumentType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>DocumentChecklistId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>Private</code></td><td><code>boolean</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>



## Exemplo de requisição



```
curl --request POST \
  --url 'https://api.zild.ai/Document' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --form 'file=@file' \
  --form 'Id={Id}' \
  --form 'Title={Title}' \
  --form 'Description={Description}' \
  --form 'FileUrl={FileUrl}' \
  --form 'DocumentStatusId={DocumentStatusId}' \
  --form 'DocumentType={DocumentType}' \
  --form 'DocumentChecklistId={DocumentChecklistId}' \
  --form 'Private={Private}'
```



## Respostas



<table class="api-params"><thead><tr><th>Status</th><th>Descrição</th><th>Corpo da resposta</th></tr></thead><tbody><tr><td><code>200</code></td><td>Documento criado com sucesso</td><td><code>application/json</code> · <code>DocumentCreateResponseDto</code></td></tr></tbody></table>

**Exemplo de resposta (200):**



```
{
  "id": 0,
  "title": "string",
  "description": "string",
  "extractedText": "string",
  "analysisText": "string",
  "fileUrl": "string",
  "documentStatusId": 0,
  "documentType": 0,
  "createdAt": "2026-09-22T18:00:00Z",
  "analizedAt": "2026-09-22T18:00:00Z",
  "documentChecklistId": 0,
  "private": true
}
```



## Modelos de dados

`DocumentCreateResponseDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>title</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>description</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>extractedText</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>analysisText</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>fileUrl</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>documentStatusId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>documentType</code></td><td><code>DocumentType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>createdAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>analizedAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>documentChecklistId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>private</code></td><td><code>boolean</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>

`DocumentType`0 = Image; 1 = Word; 2 = PDF; 3 = Text

`integer`