What does the HTTP PUT method typically do with a resource?

The HTTP PUT method is primarily used for creating or replacing a resource at the specified URI (Uniform Resource Identifier). When a client sends a PUT request, it includes the resource data in the request body, and this data completely replaces the existing resource if it already exists. If the resource does not exist, the PUT request can create it at the designated URI.

This behavior aligns with the principles of RESTful API design, where PUT represents a full update operation. As a result, PUT is not suitable for partial updates, which is a function typically associated with the PATCH method. Thus, using PUT effectively ensures that the entire resource is accurately represented as intended by the client, supporting both creation and complete replacement operations.