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

# Tarefas

As tarefas das negociações. Recurso de nível superior, filtrável por negociação.

| Método | Rota                          | Operação |
| ------ | ----------------------------- | -------- |
| GET    | `/v1/tasks`, `/v1/tasks/{id}` | `read`   |
| POST   | `/v1/tasks`                   | `insert` |
| PUT    | `/v1/tasks/{id}`              | `update` |

No payload, `owner_ids` é um **array**: uma tarefa pode ter vários responsáveis no painel. A conclusão é representada pelo booleano `is_completed`.

## Filtros

| Parâmetro                       | Comportamento                                                      |
| ------------------------------- | ------------------------------------------------------------------ |
| `deal_id`                       | inteiro ou lista separada por vírgula                              |
| `category`                      | exato, sem diferenciar maiúsculas (nome da categoria)              |
| `owner_id`                      | inteiro ou lista; corresponde a **qualquer** responsável da tarefa |
| `due_date__gte/__lte/__gt/__lt` | comparação ISO 8601                                                |
| `is_completed`                  | `true` / `false`                                                   |

**Ordenação:** `due_date`, `deal_id`, `updated_at`, `created_at` (padrão `-created_at`).

```bash
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/tasks?deal_id=310&is_completed=false"
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/tasks?owner_id=3&due_date__lte=2026-07-31&sort=due_date"
```

## Payload

```json
{
  "data": {
    "id": 77,
    "deal_id": 310,
    "name": "Ligar para confirmar proposta",
    "description": "Confirmar se o cliente recebeu o PDF da proposta.",
    "due_date": "2026-06-28T14:00:00.000Z",
    "category": "Ligação",
    "owner_ids": [3],
    "is_completed": false,
    "created_at": "2026-06-25T09:00:00.000Z",
    "updated_at": "2026-06-25T09:00:00.000Z"
  }
}
```

## Escrita

| Campo          | Tipo                    | Observações                                                                            |
| -------------- | ----------------------- | -------------------------------------------------------------------------------------- |
| `deal_id`      | inteiro                 | **obrigatório no POST**; **imutável no PUT** (422)                                     |
| `name`         | string                  | **obrigatório no POST** (título da tarefa)                                             |
| `category`     | string                  | **obrigatório no POST**; **nome** da categoria, criada automaticamente se não existir  |
| `description`  | string, anulável        |                                                                                        |
| `due_date`     | data/hora ISO, anulável |                                                                                        |
| `owner_id`     | inteiro, anulável       | responsável único na escrita; **substitui** todos os responsáveis; `null` remove todos |
| `is_completed` | booleano                | conclui ou reabre a tarefa                                                             |

```bash
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"deal_id":310,"name":"Ligar para confirmar proposta","category":"Ligação","due_date":"2026-06-28T14:00:00Z","owner_id":3}' \
  "https://app-api.atendeserver.com.br/v1/tasks"

curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"is_completed":true}' "https://app-api.atendeserver.com.br/v1/tasks/77"
```