API Shipped · contrato em movimento

A mesma superfície que o console usa

Não existe uma segunda implementação atrás do console ou da CLI: os dois falam com esta. O que também significa que ela se move quando o produto se move, e esta página é cuidadosa com o que promete.

O que é estável

POST /v1/<tenant>/<repo>/tasks
{ "title": "uma linha", "requested_by": "voce@exemplo.com" }

• Um board é um par. Cada rota é delimitada por path — /v1/<tenant>/<repo>/… — e um board é esse par, nada mais.
• O intake é uma linha. Um título cai em Triage. Um pedido que não foi delimitado não é trabalho em andamento, aqui como em todo lugar.
• O estado quem muda é o gate. A rota de scoping recusa um campo state, então nada consegue iniciar trabalho escrevendo nele por fora.

O que ainda se move

A referência completa de payloads está registrada e não escrita, e essa ordem é deliberada, não um descuido de backlog: as formas ainda estão se movendo, e documentar um contrato em movimento produz documentação que mente. O que existe está marcado como pendente; o que está acima é o que se sustentou.

Se você vai construir em cima disso agora, o handshake de versão é a primeira parte a ligar: um cliente desatualizado é avisado em uma linha, em vez de descobrir depois como um desacordo de regras.

Onde ela para

• Ela não é o caminho do enforcement. O hook nunca chama a rede para decidir, então uma queda da API não abre uma zone — ela nunca esteve no caminho da negação.
• Ela não calcula o seu diff. Um close exige um change manifest da máquina onde está o branch — cycle verify --close o constrói lá, e a API apenas o recebe.

As rotas como estão hoje ficam na referência da API (em inglês). Para quase tudo, a CLI e o servidor MCP são o caminho mais curto.