> 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/anotacoes.md).

# Anotacoes

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`).

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

## Payload

```json
{
  "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`) |

```bash
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"
```