O que significa
A requisição foi bem-sucedida e criou um novo recurso. O cabeçalho Location normalmente aponta para ele.
Causas comuns
- POST em uma coleção criou um registro
- PUT criou um recurso em uma nova URL
Como resolver
Se você é o cliente ou visitante
Leia o cabeçalho Location para obter a URL do novo recurso, ou use o corpo retornado se a API incluir o objeto criado.
Se você mantém o site ou a API
Inclua Location com a nova URL e, de preferência, a representação criada. Não retorne 201 quando nada foi criado; novas tentativas idempotentes que encontram um item existente podem retornar 200 ou 409.
Resposta de exemplo
HTTP/1.1
HTTP/1.1 201 Created
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /users/42
Content-Type: application/json
{
"id": 42,
"name": "Ada"
}Especificação
Perguntas frequentes
› O cabeçalho Location é obrigatório com 201?
É fortemente recomendado. Sem ele, os clientes precisam adivinhar a nova URL a partir do corpo.
› Qual a diferença entre 201 e 202?
201 significa que o recurso já existe agora. 202 significa que a requisição foi aceita e será processada depois.