Tarefas

Gerenciamento de tarefas, follow-ups e calendário de atividades.

GET /api/tasks Auth

Listar Tarefas

Retorna a lista paginada de tarefas do usuário.

Query Parameters

page integer

Número da página

limit integer

Itens por página (máx: 100)

Status Codes

200 Lista retornada com sucesso

401 Não autenticado

Response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439044",
      "title": "Follow-up proposta Tech Solutions",
      "description": "Ligar para Maria sobre desconto",
      "dueDate": "2026-05-10T14:00:00Z",
      "priority": "high",
      "completed": false,
      "contactId": "507f1f77bcf86cd799439011",
      "dealId": "507f1f77bcf86cd799439033",
      "createdAt": "2026-05-07T10:00:00Z"
    }
  ],
  "total": 18,
  "page": 1,
  "limit": 20
}

POST /api/tasks Auth

Criar Tarefa

Cria uma nova tarefa vinculada opcionalmente a um contato ou negócio.

Request Body

title string obrigatório

Título da tarefa

description string opcional

Descrição detalhada

dueDate string opcional

Data de vencimento (ISO 8601)

priority string opcional

Prioridade: low, medium, high

contactId string opcional

ID do contato relacionado

dealId string opcional

ID do negócio relacionado

Status Codes

201 Criado com sucesso

400 Dados inválidos

401 Não autenticado

Request

{
  "title": "Follow-up proposta Tech Solutions",
  "description": "Ligar para Maria sobre desconto",
  "dueDate": "2026-05-10T14:00:00Z",
  "priority": "high",
  "contactId": "507f1f77bcf86cd799439011",
  "dealId": "507f1f77bcf86cd799439033"
}

Response

{
  "id": "507f1f77bcf86cd799439044",
  "title": "Follow-up proposta Tech Solutions",
  "description": "Ligar para Maria sobre desconto",
  "dueDate": "2026-05-10T14:00:00Z",
  "priority": "high",
  "completed": false,
  "createdAt": "2026-05-07T10:00:00Z"
}

GET /api/tasks/:id Auth

Buscar Tarefa por ID

Retorna os dados completos de uma tarefa específica.

Status Codes

200 Registro encontrado

401 Não autenticado

403 Sem permissão (não é o proprietário)

404 Não encontrado

Response

{
  "id": "507f1f77bcf86cd799439044",
  "title": "Follow-up proposta Tech Solutions",
  "description": "Ligar para Maria sobre desconto",
  "dueDate": "2026-05-10T14:00:00Z",
  "priority": "high",
  "completed": false,
  "contactId": "507f1f77bcf86cd799439011",
  "dealId": "507f1f77bcf86cd799439033",
  "createdAt": "2026-05-07T10:00:00Z"
}

PUT /api/tasks/:id Auth

Atualizar Tarefa

Atualiza os dados de uma tarefa existente.

Request Body

title string opcional

Título

description string opcional

Descrição

dueDate string opcional

Data de vencimento (ISO 8601)

priority string opcional

Prioridade: low, medium, high

Status Codes

200 Atualizado com sucesso

400 Dados inválidos

401 Não autenticado

403 Sem permissão (não é o proprietário)

404 Não encontrado

Request

{
  "dueDate": "2026-05-12T14:00:00Z",
  "priority": "medium"
}

Response

{
  "id": "507f1f77bcf86cd799439044",
  "title": "Follow-up proposta Tech Solutions",
  "dueDate": "2026-05-12T14:00:00Z",
  "priority": "medium",
  "updatedAt": "2026-05-07T15:30:00Z"
}

DELETE /api/tasks/:id Auth

Remover Tarefa

Remove permanentemente uma tarefa.

Status Codes

200 Removido com sucesso

401 Não autenticado

403 Sem permissão (não é o proprietário)

404 Não encontrado

Response

{
  "message": "Tarefa excluída com sucesso"
}

POST /api/tasks/:id/complete Auth

Marcar como Concluída

Marca uma tarefa como concluída. Define o campo completed como true e registra a data.

Status Codes

200 Tarefa concluída

403 Sem permissão

404 Não encontrada

Response

{
  "id": "507f1f77bcf86cd799439044",
  "title": "Follow-up proposta Tech Solutions",
  "completed": true,
  "completedAt": "2026-05-07T16:00:00Z"
}

GET /api/tasks/overdue Auth

Tarefas Atrasadas

Retorna todas as tarefas cujo prazo já venceu e ainda não foram concluídas.

Status Codes

200 Lista retornada com sucesso

401 Não autenticado

Response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439044",
      "title": "Enviar contrato assinado",
      "dueDate": "2026-05-01T00:00:00Z",
      "priority": "high",
      "completed": false
    }
  ],
  "total": 3
}

GET /api/tasks/upcoming Auth

Tarefas Próximas

Retorna as tarefas com vencimento nos próximos 7 dias.

Status Codes

200 Lista retornada com sucesso

401 Não autenticado

Response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439045",
      "title": "Reunião cliente XYZ",
      "dueDate": "2026-05-09T10:00:00Z",
      "priority": "high",
      "completed": false
    }
  ],
  "total": 5
}

GET /api/tasks/calendar Auth

Calendário de Tarefas

Retorna tarefas agrupadas por data para exibição em calendário.

Query Parameters

start string

Data início do período (ISO 8601)

end string

Data fim do período (ISO 8601)

Status Codes

200 Lista retornada com sucesso

401 Não autenticado

Response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439044",
      "title": "Follow-up Tech Solutions",
      "dueDate": "2026-05-10T14:00:00Z",
      "priority": "high",
      "completed": false
    }
  ]
}