Em que casos deve-se usar uma requisição HTTP do método PUT?

O método HTTP PUT é usado para criar ou substituir um recurso na URI especificada. É utilizado quando é necessário atualizar completamente um recurso existente ou criar um novo se não existir. Ao contrário do POST, o PUT é idempotente: requisições repetidas com os mesmos dados não alteram o resultado.

Exemplo de uso do PUT:

• Atualizar o perfil do usuário na URL /users/123 com novos dados.
• Carregar um arquivo no servidor com um nome específico, onde cada PUT sobrescreve o arquivo.

PUT /users/123 HTTP/1.1
Content-Type: application/json

{
  "name": "Ivan",
  "email": "ivan@example.com"
}