Why does an HTTP PUT request have to contain a representation of a \'whole\' state and can\'t just be a partial?
I understand that this is the existing definition of
With a full document update, it's obvious, without knowing any details of the particular API or what its limitations on the document structure are, what the resulting document will be after the update.
If a certain method was known to never be a partial content update, and an API someone provided only supported that method, then it would always be clear what someone using the API would have to do to change a document to have a given set of valid contents.