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

# Arquivos

Os arquivos anexados a uma negociação. O campo `url` é um endereço público permanente.

| Método | Rota                      | Operação |
| ------ | ------------------------- | -------- |
| GET    | `…/files`, `…/files/{id}` | `read`   |
| POST   | `…/files`                 | `insert` |
| DELETE | `…/files/{id}`            | `delete` |

Sem filtros. **Ordenação:** `name`, `created_at` (padrão `-created_at`).

## Upload

`POST …/files` recebe **`multipart/form-data`** com o binário no campo `file` e um campo de texto opcional `name` que substitui o nome original do arquivo.

* **Tipos aceitos:** PDF, documentos Office (Word, Excel, PowerPoint), texto simples, imagens JPEG/PNG/WebP, vídeo MP4 e formatos comuns de áudio.
* **Limites de tamanho** (medidos sobre a requisição completa):
  * imagens JPEG/PNG: **5 MB**
  * vídeo MP4 e áudio OGG: **16 MB**
  * demais tipos (inclusive WebP e os outros formatos de áudio): até **100 MB**
* Upload rejeitado retorna 422 no campo `file`.
* A exclusão remove o arquivo da negociação.

{% hint style="warning" %}
Informe o tipo MIME no envio. O padrão do curl (`application/octet-stream`) é rejeitado.
{% endhint %}

```bash
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/deals/310/files?sort=name"

# informe o tipo MIME: o padrão do curl (application/octet-stream) é rejeitado
curl -X POST -H "Authorization: Bearer $KEY" \
  -F "file=@contrato_assinado.pdf;type=application/pdf" -F "name=Contrato assinado.pdf" \
  "https://app-api.atendeserver.com.br/v1/deals/310/files"

curl -X DELETE -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/deals/310/files/55"
```

## Payload

```json
{
  "data": {
    "id": 55,
    "deal_id": 310,
    "name": "Contrato assinado.pdf",
    "url": "https://static-wp01.atendeserver.com.br/anexos/ab12cd-contrato_assinado.pdf",
    "created_at": "2026-06-24T13:00:00.000Z"
  }
}
```