Erros

Todas as respostas de erro seguem o mesmo formato:

{ "detail": "Mensagem de erro legível." }

Códigos de status

Status	Significado
`400`	Requisição inválida (corpo malformado).
`401`	Credencial ausente ou inválida.
`403`	Papel insuficiente, ou acesso do agente negado (ferramenta não aprovada).
`404`	Recurso não encontrado.
`409`	Conflito (ex.: nome de ferramenta duplicado).
`422`	Erro de validação dos dados enviados.
`429`	Limite de uso atingido (ex.: mensagens do mês).
`500`	Erro interno.

403 em /agents/{id}/chat — o agente está suspenso/pendente ou tentou usar uma ferramenta não aprovada. No segundo caso, o evento conversation.tool_blocked (crítico) é registrado na auditoria.
400 por escudo anti-injeção — quando o escudo está em modo bloquear, a resposta indica o nível de risco e os padrões detectados. Veja Escudo anti-injeção.
429 — limite do plano atingido. Veja Planos e uso.