3.1.4.2 Request to Insert Resources

When a higher layer needs to insert entities into a data service, it MUST cause the client to send the appropriate Insert request type, as specified in Insert Request Types (section 2.2.7.1) and as detailed in the remainder of this section.

The higher layer MUST provide the URI, which the higher layer obtained from a prior data service response or other means that will be specified in all requests sent by the client. As defined by the Insert request types, Insert Request Types (section 2.2.7.1), the URI MUST identify the EntitySet or collection of entities that the new EntityType instance is to be inserted into. In addition, the higher layer MAY specify the preference/hint about whether to include an entity that represents the current state of the resource in the response to a successful insert request by using the Prefer (section 2.2.5.9) header.