> 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

POST`/api/public/v1/organizations/{orgId}/projects/{projectId}/issues`REST API

Quando stateId é null ou omitido, usa o estado padrão. O contrato público não recebe responsáveis, prazo ou anexos. Não há contrato genérico de Idempotency-Key: reconcilie o resultado antes de repetir um POST cuja resposta se perdeu.

## Autenticação

`WorkApiToken`

## Parâmetros

| Nome      | Local | Tipo   | Obrigatório | Descrição                     |
| --------- | ----- | ------ | ----------- | ----------------------------- |
| orgId     | path  | string | Sim         | UUID da organização do token. |
| projectId | path  | string | Sim         | UUID do projeto.              |

## Corpo da requisição

### application/json

Tipo: [Referência: CreateIssueRequest](https://developers.orbita.nexxo.tec.br/referencia/schema-createissuerequest.md)

[Schema CreateIssueRequest](https://developers.orbita.nexxo.tec.br/referencia/schema-createissuerequest.md)

## Respostas

### 201

Sucesso.

[Schema Issue](https://developers.orbita.nexxo.tec.br/referencia/schema-issue.md)

### 401

Token inválido, ausente, expirado ou revogado.

### 403

Organização ou política de acesso não permite a operação.

### 422

Validação rejeitada; consulte os detalhes retornados.

### 429

Limite por token atingido; corpo e Retry-After não são garantidos.

## Exemplo

```bash
curl --request POST \
  --url 'https://api.example.invalid/api/public/v1/organizations/{orgId}/projects/{projectId}/issues' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN'
```
