Tarefas

/v1/tasks · as tarefas das negociações, filtráveis por negociação e responsável.

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

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

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

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"