2.2.7.6.1.1 Referencing Requests in a Change Set

To enable referencing a new entity created via an Insert request, as described in Insert Request Types (section 2.2.7.1), from a subsequent request within the same change set, this document defines a request referencing mechanism.

Each MIME part that represents a request in a change set MUST include a Content-ID MIME header as an HTTP header of the MIME part request. If a MIME part defines an InsertEntity request or invokes an action that returns an entity, then the entity, as defined by the InsertEntity request or action invocation, MAY be referenced by subsequent requests in the change set by using the "$<Content-ID value of previous request>" token as the root of the resource path that is used in a subsequent request within the change set. When used in this way, the token acts as an alias for the resource path that identifies the new entity. Requests in different change sets cannot reference one another, even if they are in the same batch.