Anotacoes

/v1/deals/{dealId}/annotations · a linha do tempo completa de uma negociação, com anotações da equipe e registros do sistema.

A linha do tempo completa de uma negociação: anotações da equipe e os registros gerados pelo sistema (movimentações de estágio, tarefas, arquivos, propostas etc.). Registros do sistema têm user_id: null. Filtre por user_id para isolar as anotações humanas.

Método	Rota	Operação
GET	…/annotations, …/annotations/{id}	read
POST	…/annotations	insert

Filtros

Parâmetro	Comportamento
user_id	inteiro ou lista separada por vírgula (autor)
registered_at__gte/__lte/__gt/__lt	comparação ISO 8601

Ordenação: registered_at (padrão -registered_at).

curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/deals/310/annotations?registered_at__gte=2026-06-01"

Payload

{
  "data": {
    "id": 1204,
    "deal_id": 310,
    "description": "Cliente pediu para retornar a ligação na próxima semana.",
    "user_id": 3,
    "registered_at": "2026-06-22T17:10:00.000Z"
  }
}

Escrita

Campo	Tipo	Observações
description	string	obrigatório (o texto da anotação)
user_id	inteiro, anulável	autor opcional (usuário da conta); ausente ou null registra a anotação como do sistema (user_id: null)

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"description":"Cliente pediu retorno na próxima semana.","user_id":3}' \
  "https://app-api.atendeserver.com.br/v1/deals/310/annotations"