Kanban

Campos e filtros do Kanban

O formato do cartão, os filtros de busca e como paginar.

Nesta página

Cartão (Card)

idboard_idboard_namestage_idstage_namestage_kindpositiontitledescriptionprioritydue_atlabelsversionarchivedclosed_atcreated_atupdated_atchecklist_totalchecklist_donechecklistassignee_idassignee_nameurlcreated_bycreated_by_nameupdated_byupdated_by_nameattachment_countattachmentscustom_values

Campos por operação

Operação	Corpo JSON
Editar cartão	`title` (até 200 caracteres); `description` (até 10.000 bytes UTF-8); `priority` (`low`, `medium`, `high`, `urgent`); `due_at` (RFC 3339; aceita null); `label_ids` (até 20 itens; lista de UUIDs); `version` (mínimo 1); `assignee_id` (UUID; aceita null); `custom_values`.
Criar cartão	`title` obrigatório (até 200 caracteres); `description` (até 10.000 bytes UTF-8); `stage_id` (UUID); `priority` (`low`, `medium`, `high`, `urgent`); `due_at` (RFC 3339; aceita null); `label_ids` (até 20 itens; lista de UUIDs); `checklist` (até 100 itens; lista de string); `assignee_id` (UUID); `template_id` (UUID); `custom_values`.
Mover cartão	`stage_id` obrigatório (UUID); `version` (mínimo 1); `before_id` (UUID); `after_id` (UUID); `place` (`start`, `end`).
Adicionar comentário	`text` obrigatório (até 10.000 caracteres); `notify` (boolean); `mentions` (até 20 itens; lista de UUIDs).
Adicionar checklist	`text` (até 300 caracteres); `items` (até 100 itens; lista de string).
Editar checklist	`text` (até 300 caracteres); `done` (boolean); `position`.
Editar comentário da própria chave	`text` obrigatório (até 10.000 caracteres).

Prioridades: low, medium, high, urgent. Datas usam RFC 3339, como 2026-10-10T18:00:00Z. Para remover o prazo, envie due_at: null. Campos desconhecidos são rejeitados.

Paginação por cursor

As listas devolvem items e next_cursor, com até 100 itens por página. Repita a chamada com os mesmos filtros, passando cursor (codificado para URL), até next_cursor vir nulo.

Respostajson

{
  "items": [ … ],
  "next_cursor": "eyJpZCI6ImNyZF8yOTEifQ"
}

Filtros de GET /kanban/cards

board_idlimitcursorqprioritylabelduetzstatusarchivedsortstage_idassigneeupdated_sinceview

Filtro	Valores
`board_id`	UUID
`limit`	mínimo 1; máximo 100; padrão `30`
`cursor`	Texto
`q`	até 100 caracteres
`priority`	`low`, `medium`, `high`, `urgent`
`label`	UUID
`due`	`any`, `today`, `week`, `overdue`, `none`
`tz`	padrão `America/Sao_Paulo`
`status`	`all`, `open`, `closed`
`archived`	`0`, `1`
`sort`	`updated`, `created`, `due`; padrão `updated`
`stage_id`	Só cartões desta etapa.
`assignee`	UUID, none ou me.
`updated_since`	Alterados a partir de (RFC 3339).
`view`	`compact`