API — 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 do tópico. Se você enviar só o `nome`, o identificador curto é gerado a partir dele; se enviar só o `slug`, ele também serve de nome até alguém ajustar na tela.
`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 que já existe não duplica o tópico. Se você mandar só o slug, o tópico é apenas localizado e nada nele muda — use isso para garantir que ele existe antes de enviar tarefas. O nome só é alterado quando você envia nome, para que um ajuste feito na tela não seja desfeito pela integração.

A concessão de tópicos às equipes é feita na interface do sistema, na tela da equipe — veja Equipes.