Pedido inválido (validation_error, invalid_request, invalid_cursor)

Sintoma

A consola mostra que um campo não é válido (normalmente junto ao campo), ou «A página pedida deixou de ser válida. A lista foi reiniciada em segurança.» A API responde 422 validation_error (com field), 400 invalid_request, 400 invalid_idempotency_key, 413 payload_too_large ou 422 invalid_cursor.

Causa

• Um valor fora das regras: comprimento, formato (email, UUID, SID, CIDR, URL https), intervalo numérico ou campo desconhecido.
• Um corpo JSON mal formado ou demasiado grande.
• Uma chave de idempotência em falta ou com caracteres inválidos.
• Um cursor de paginação antigo (a lista mudou ou expirou).

Solução

1. Leia a mensagem junto ao campo indicado e corrija o valor. As regras estão no artigo de cada vista.
2. Numa integração, use o field da resposta para saber o que corrigir e confirme o pedido contra o OpenAPI (campos desconhecidos são recusados).
3. Num cursor inválido, recomece a lista na primeira página.
4. Corpos grandes: divida o pedido (por exemplo, importações de âncoras até 500 linhas).

Quando escalar

Se um valor que cumpre as regras documentadas é recusado, contacte o suporte com o campo, o valor (sem segredos) e a hora.