Formato das coleções
Listagens de projetos e issues retornam o envelope:
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
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.