POST
Since the caller knows all the data on a resource when POST for the resource, the response to a POST on a singular resource will only include:
-
A HTTP status of 200 (OK) or 201 (Created)
-
An indicator of success or failure, possibly the HTTP status.
-
A location header (see RFC7231) indicating the path to the resource created/updated.
Optionally, the response may include:
-
The entire resource created/updated
-
A subset of the resource created/updated
-
The links that would be on returned on a GET of that resource given the resource's current (or new) state.