Prepare o projeto

Obtenha o UUID do projeto na listagem de projetos. O orgId precisa corresponder à organização do token. O título é obrigatório e aceita até 500 caracteres.

Envie a criação

curl --fail-with-body   --request POST   "$ORBITA_API_ORIGIN/api/public/v1/organizations/$ORBITA_ORGANIZATION_ID/projects/$ORBITA_PROJECT_ID/issues"   --header "X-Api-Key: $ORBITA_API_KEY"   --header 'Content-Type: application/json'   --data '{"title":"Revisar fluxo de entrada","description":"Conferir mensagens e validações.","priority":"Medium"}'

O sucesso retorna 201 Created e o DTO da issue, incluindo id e key. Se stateId for omitido ou null, o servidor usa o estado padrão configurado no projeto. A prioridade omitida usa None.

O payload público aceita title, description, stateId, priority e labelIds. Responsáveis, prazo, anexos, subissues e recorrência não fazem parte desse request público.

Confirme e guarde o resultado

Persistir o id evita depender de busca por título. Use GET /api/public/v1/organizations/{orgId}/issues/{id} para consultar o item criado.

Se a conexão cair depois do envio, a criação pode ter ocorrido. O contrato público não oferece idempotência genérica: reconcilie o resultado antes de repetir o POST. A publicação idempotente de rascunhos usada pela interface pertence a outro contrato.

Para receber uma demanda que ainda precisa de aprovação, use triagem.