Bulk version a set of properties

POST https://{{host}}/papi/v1/bulk/property-version-creations

Create new versions of a set of properties based on any previous version. This operation launches an asynchronous process to increment versions. To check its progress, run the List bulk-versioned properties operation, whose link is available in the Location header or bulkCreateVersionLink member of this operation's response. Run this operation only after bulk searching a set of properties you want to change, to prepare new versions to bulk patch. See Bulk Search and Update for guidance on this feature.

Request Params

KeyDatatypeRequiredDescription
contractIdstring(Optional) Optionally filters bulk searches to properties created under the specified contract. For bulk operations, you can specify contractId and groupId independently from each other.
groupIdstring(Optional) Optionally filters bulk searches to properties created under the specified group. For bulk operations, you can specify contractId and groupId independently from each other.
accountSwitchKeystring(Optional) For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Request Body

{"createPropertyVersions"=>[{"createFromVersion"=>1, "createFromVersionEtag"=>"2641910c585cf67b", "propertyId"=>"prp_1"}, {"createFromVersion"=>2, "createFromVersionEtag"=>"343410c585cf67fc", "propertyId"=>"prp_15"}, {"createFromVersion"=>10, "createFromVersionEtag"=>"6c7v5c65c6cvcv65", "propertyId"=>"prp_3"}]}

HEADERS

KeyDatatypeRequiredDescription
PAPI-Use-Prefixesstring(Required) Enum Sets whether to represent ID prefixes in response data. Set to false when exchanging PAPI data with other APIs.
Content-Typestring
Acceptstring