Erros

Erros seguem sempre o mesmo formato:

{
  "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
`5xx`	Erro interno	Tente novamente com backoff; se persistir, contate o suporte

{
  "statusCode": 403,
  "message": "API key sem o(s) escopo(s): tickets:write"
}

Campos não documentados no corpo são rejeitados (400), não ignorados. Isso evita erros silenciosos de digitação.

⌘I