TrueURL

422 Unprocessable Content

A requisição está bem formada, mas o conteúdo é semanticamente inválido, em geral um erro de validação em uma API. Antes se chamava “Unprocessable Entity”.

Frase de motivo
Unprocessable Content
Redirecionamento
Não
Cacheável por padrão
Não

422 Unprocessable Content significa que o servidor entende o tipo de conteúdo e que a sintaxe da requisição está correta, mas que ele não consegue processar as instruções contidas nela. Por exemplo, um corpo JSON é interpretado sem problemas, mas um campo de e-mail é inválido ou um valor obrigatório está fora do intervalo permitido.

O WebDAV (RFC 4918) introduziu o código como “Unprocessable Entity”, e a RFC 9110 o incorporou ao núcleo do HTTP com o nome novo. Muitos frameworks web e APIs, como Ruby on Rails e Laravel, o usam em erros de validação e retornam mensagens por campo no corpo.

Use o 400 e o 422 de forma consistente: 400 para requisições que não podem ser interpretadas, 422 para requisições que podem ser interpretadas, mas não passam na validação.

Exemplo de resposta

HTTP
HTTP/1.1 422 Unprocessable Content
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: application/json
Content-Length: 77

{"message":"Validation failed","errors":[{"field":"email","code":"invalid"}]}

SEO e verificação de redirecionamentos

O 422 é um código de APIs e de processamento de formulários. Os rastreadores usam GET e não deveriam vê-lo; uma página que retorna 422 para GET é tratada como um erro 4xx e não é indexada.

Causas comuns e casos de uso

  • O envio de um formulário ou uma chamada de API não passa na validação: um campo ausente, um endereço de e-mail inválido ou um nome de usuário já em uso.
  • Um documento é um JSON válido, mas não segue o schema da API.
  • O corpo de um PROPPATCH ou LOCK do WebDAV é um XML bem formado, mas semanticamente errado.

Verificador de redirecionamento de URL

Veja todos os códigos de status que uma URL retorna, salto a salto, com o verificador de redirecionamento gratuito do TrueURL.