Erros

Erros seguem o formato application/problem+json, com um campo code estável pra tratar por programa e um type que aponta pra esta página (.../docs/api/erros#<code>).

validation_error

Algum parâmetro ou o corpo da requisição está fora do formato esperado. Status 400.

not_found

O recurso pedido não existe ou não é seu. Status 404.

insufficient_scope

Sua chave é só de leitura (dinzo:read) e a operação exige escrita (dinzo:write). Reconecte pedindo leitura e escrita. Status 403.

rate_limited

Você passou do limite de requisições. Veja o cabeçalho Retry-After e tente de novo depois. Status 429.

UPGRADE_REQUIRED

A API e o MCP são recursos do Premium e do Ultra. Status 403.