Arquivos

/v1/deals/{dealId}/files · upload multipart, tipos aceitos e limites de tamanho dos anexos da negociação.

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.

Informe o tipo MIME no envio. O padrão do curl (application/octet-stream) é rejeitado.

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

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

AnteriorAnotacoes

PróximoPropostas