Formato das coleções

Listagens de projetos e issues retornam o envelope:

{
  "items": [],
  "total": 0,
  "page": 1,
  "pageSize": 20
}

total é o total de itens encontrados; page começa em 1. O padrão do controller público é page=1 e pageSize=20. Não existe cursor neste envelope.

Percorra páginas até atingir total ou receber uma página vazia. Como os dados podem mudar durante a leitura, deduplique os itens pelo UUID se precisar montar um catálogo local.

Filtros públicos

OperaçãoQuery parameters
Listar projetospage, pageSize
Listar issues de um projetostateId, priority, page, pageSize

stateId é o UUID do estado. priority usa None, Low, Medium, High ou Urgent. Issues arquivadas não são incluídas por essa listagem pública.

A API privada e o MCP oferecem filtros adicionais. Não envie filtros de responsáveis, labels, texto ou datas à API pública esperando o mesmo comportamento: eles não são recebidos por seu controller atual.

Identificadores

organizationId, projectId e id são UUIDs. key, como ORB-42, é uma identificação legível calculada pelo servidor. Preserve os dois quando sua integração precisar consultar e mostrar o trabalho.