PUT
Replaces the target resource with the request payload. PUT is idempotent—multiple identical requests have the same effect as one. Used for full updates.
Properties
- Safe
- No
- Idempotent
- Yes
- Has body
- Yes
Typical use cases
Full resource replacement, upsert (create or replace)
cURL example
curl -X PUT -H "Content-Type: application/json" -d '{"name":"Alex","email":"alex@new.com"}' https://api.example.com/users/1Typical response
{"id":1,"name":"Alex","email":"alex@new.com"}Common status codes
200 OK204 No Content400 Bad Request404 Not Found500 Server Error
Comparison with similar methods
PUT replaces entire resource; PATCH does partial update. PUT is idempotent.