> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Tarefas (To-Do List): Crie e Acompanhe Pendências

> Crie, liste, atualize e exclua tarefas internas, e consulte o histórico de alterações por usuário, via API externa do PanÐá Zap.

A lista de tarefas (To-Do List) do PanÐá Zap permite que agentes acompanhem pendências internas — ligações de retorno, follow-ups, checklists — associadas ou não a um atendimento. Use os endpoints abaixo para criar e sincronizar tarefas a partir de um sistema externo de produtividade ou automação.

Todas as requisições exigem o cabeçalho `Authorization: Bearer {BearerToken}`.

***

## Criar tarefa

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/todo/create
```

```json theme={null}
{
  "name": "Ligar para cliente",
  "description": "Confirmar proposta",
  "owner": "João",
  "ownerId": 7,
  "status": "pending",
  "priority": "high"
}
```

| Campo         | Tipo    | Obrigatório | Descrição                                                      |
| ------------- | ------- | ----------- | -------------------------------------------------------------- |
| `name`        | string  | Sim         | Título da tarefa.                                              |
| `description` | string  | Não         | Detalhes adicionais sobre a tarefa.                            |
| `owner`       | string  | Não         | Nome de exibição do responsável.                               |
| `ownerId`     | integer | Não         | ID do usuário responsável pela tarefa.                         |
| `status`      | string  | Não         | Status inicial — por exemplo, `pending` ou `finished`.         |
| `priority`    | string  | Não         | Prioridade da tarefa — por exemplo, `low`, `medium` ou `high`. |

***

## Listar tarefas

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/todo/list
```

***

## Consultar histórico de tarefas por usuário

Retorna o log de alterações de tarefas atribuídas a um usuário específico — útil para auditoria de produtividade.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/todo/logs/{userId}
```

| Parâmetro de Caminho | Tipo    | Obrigatório | Descrição                                                |
| -------------------- | ------- | ----------- | -------------------------------------------------------- |
| `userId`             | integer | Sim         | ID do usuário cujo histórico de tarefas será consultado. |

***

## Atualizar tarefa

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/todo/update/{id}
```

```json theme={null}
{ "status": "finished" }
```

| Parâmetro                                                              | Tipo    | Obrigatório | Descrição                                                                                             |
| ---------------------------------------------------------------------- | ------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| `id` (caminho)                                                         | integer | Sim         | ID da tarefa a atualizar.                                                                             |
| `status`, `name`, `description`, `owner`, `ownerId`, `priority` (body) | —       | Não         | Aceita os mesmos campos de [Criar tarefa](#criar-tarefa) — envie apenas os campos que deseja alterar. |

***

## Excluir tarefa

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/todo/delete/{id}
```

Nenhum corpo de requisição é necessário.

***

## Resposta Padrão

```json theme={null}
{
  "success": true,
  "data": { ... }
}
```