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.