> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiseapp360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erros

> Códigos HTTP e formato das respostas de erro.

Erros seguem sempre o mesmo formato:

```json theme={null}
{
  "statusCode": 400,
  "message": ["title should not be empty", "priority must be one of: urgent, high, medium, low"]
}
```

`message` é uma string ou, em erros de validação, uma lista com um item por campo inválido.

| Código | Significado | O que fazer |
| - | - | - |
| `400` | Requisição inválida (validação, ID mal formatado, campo desconhecido) | Corrija o corpo/parâmetros conforme `message` |
| `401` | API key ausente, inválida, expirada ou revogada | Verifique o header e a key no painel |
| `403` | Sem permissão: escopo ausente (`insufficient_scope`), recurso de outra empresa ou ambiente Agile desabilitado | Ajuste os escopos ou o recurso |
| `404` | Recurso não encontrado | Confira o ID |
| `409` | Conflito (ex.: identificador de cliente final duplicado) | Use outro valor |
| `429` | Rate limit excedido | Aguarde `Retry-After` — veja [Rate limits](/guias/rate-limits) |
| `5xx` | Erro interno | Tente novamente com backoff; se persistir, contate o suporte |

### Escopo insuficiente

```json theme={null}
{
  "statusCode": 403,
  "message": "API key sem o(s) escopo(s): tickets:write"
}
```

> [!TIP]
>
> Campos não documentados no corpo são **rejeitados** (`400`), não ignorados. Isso evita erros silenciosos de digitação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.