Tópicos
Os tópicos roteiam as tarefas para as equipes. Pela API você pode listá-los e criá-los — útil para garantir que um tópico exista antes de enviar tarefas com ele.
Listar tópicos
GET /api/v1/topics
{
"topicos": [
{ "id": 3, "slug": "fiscal", "nome": "Fiscal", "equipes": 2, "tarefas": 14 }
]
}
Criar ou atualizar um tópico
POST /api/v1/topics
| Campo | Obrigatório | Descrição |
|---|---|---|
slug |
sim* | Identificador curto, em letras minúsculas (ex.: fiscal). |
nome |
não | Nome de exibição. Usado como slug se este não for informado. |
descricao |
não | Descrição do tópico. |
* Você pode enviar apenas nome — o slug é derivado dele.
POST /api/v1/topics
Authorization: Bearer SEU_TOKEN
Content-Type: application/json
{ "slug": "fiscal", "nome": "Fiscal", "descricao": "Assuntos fiscais" }
Resposta:
{ "id": 3, "slug": "fiscal" }
Enviar um slug já existente atualiza o tópico (não duplica). A concessão de
tópicos às equipes é feita por um administrador na interface do sistema.