> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Criar uma issue

## 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

```bash
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](https://developers.orbita.nexxo.tec.br/guias/enviar-para-triagem.md).
