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

> ## Agent Instructions
> Leia /llms.txt antes de explorar páginas. A API HTTP usa Authorization: Bearer com o JWT da conta. A chave kl_live_ serve só ao assistente MCP e não substitui o JWT. Não invente rotas, hosts públicos, SDKs ou CLI. companyId e userId vêm da sessão. Consultas não aceitam SQL. Exclusão no assistente exige confirm=true. O webhook público é POST /webhook/leads.

# Tarefa

> O item que anda no quadro. Na consulta a entidade é `tasks`. No caminho HTTP ainda aparece `/called`.

O item que anda no quadro. Na consulta a entidade é `tasks`. No caminho HTTP ainda aparece `/called`.

> [card] Obrigatório
>
> `title`, `boardStatusId`, `boardPriorityId`, `client` (uuid), `date_start` e `date_end`. `date_sprint` substitui as duas datas.

## Fluxo

1. Liste o quadro, o status e a prioridade.
2. Liste o cliente e use o uuid.
3. Crie com título, ids e datas `YYYY-MM-DD`.
4. Mova de status ou prioridade com as operações de atualização.

## Operações

| Você quer | Método | Caminho |
| - | - | - |
| [Tarefas](https://docs.kinglog.com.br/pages/reference/tasks/tasks-list.md) | `POST` | `/called/getAll` |
| [Uma tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-getOne.md) | `POST` | `/called/getOne` |
| [Criar tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-create.md) | `POST` | `/called/create` |
| [Atualizar tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-update.md) | `POST` | `/called/update` |
| [Mover status da tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-updateStatus.md) | `PUT` | `/called/updateStatus` |
| [Prioridade da tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-updatePriority.md) | `PUT` | `/called/updatePriority` |
| [Duplicar tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-duplicate.md) | `POST` | `/called/duplicate` |
| [Arquivar tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-archive.md) | `GET` | `/called/archive/:calledId/:userId/:companyId/:value` |
| [Excluir tarefa](https://docs.kinglog.com.br/pages/reference/tasks/tasks-delete.md) | `DELETE` | `/called/delete/:calledId/:userId/:companyId` |

## Exemplo de requisição

```json theme={null}
{
  "title": "Tarefa de exemplo",
  "boardStatusId": 1,
  "boardPriorityId": 1,
  "client": "UUID_DO_CLIENTE",
  "date_start": "2026-11-05",
  "date_end": "2026-11-05",
  "companyId": "UUID_DA_EMPRESA",
  "userId": "UUID_DO_USUARIO"
}
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "data": {
    "id": 1,
    "title": "Tarefa de exemplo",
    "boardStatusId": 1,
    "boardPriorityId": 1,
    "client": "UUID_DO_CLIENTE",
    "date_start": "2026-11-05",
    "date_end": "2026-11-05"
  },
  "code": "SUCCESS"
}
```

> [!TIP]
>
> `client` é o uuid do cliente, nunca o nome. Liste quadro, status, prioridade e cliente antes de criar.

> [!TIP]
>
> O responsável padrão é o usuário da sessão. Envie `responsibleId` para atribuir a outra pessoa.

## Relacionado

* [Guia: primeira tarefa](https://docs.kinglog.com.br/pages/guides/primeira-tarefa.md)
* [Comentário](https://docs.kinglog.com.br/pages/reference/trabalho/comentario.md)
* [Checklist](https://docs.kinglog.com.br/pages/reference/trabalho/checklist.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.