Kanban

Exemplos do Kanban

Um fluxo completo em cinco chamadas.

Nesta página

Os exemplos usam as variáveis NEXTCHAT_API e NEXTCHAT_API_KEY de Primeiros passos. Troque ID_DO_QUADRO, ID_DO_CARTAO e ID_DA_ETAPA pelos IDs que a API devolve.

1. Listar quadros

GET/kanban/boardsbash

curl "$NEXTCHAT_API/kanban/boards" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY"

A resposta traz cada quadro com as etapas em stages.

2. Criar cartão

POST/kanban/boards/{id}/cardsbash

curl -X POST "$NEXTCHAT_API/kanban/boards/ID_DO_QUADRO/cards" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"title":"Instalação · Padaria Pão Quente","priority":"high"}'

Retorna 201 com o cartão criado, incluindo id e version. Sem stage_id, ele entra na primeira etapa aberta.

3. Editar com versão

PATCH/kanban/cards/{id}bash

curl -X PATCH "$NEXTCHAT_API/kanban/cards/ID_DO_CARTAO" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H 'If-Match: "v1"' \
  -H "Content-Type: application/json" \
  -d '{"due_at":"2026-10-20T14:00:00-03:00"}'

Use a versão que você consultou: no cabeçalho If-Match ou como version no corpo.

4. Mover de etapa

POST/kanban/cards/{id}/movebash

curl -X POST "$NEXTCHAT_API/kanban/cards/ID_DO_CARTAO/move" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"stage_id":"ID_DA_ETAPA","version":2}'

5. Comentar o resultado

POST/kanban/cards/{id}/commentsbash

curl -X POST "$NEXTCHAT_API/kanban/cards/ID_DO_CARTAO/comments" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"text":"Instalação concluída."}'