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
Key | Datatype | Required | Description |
---|---|---|---|
contractId | string | (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. | |
groupId | string | (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. | |
accountSwitchKey | string | (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
Key | Datatype | Required | Description |
---|---|---|---|
PAPI-Use-Prefixes | string | (Required) Enum Sets whether to represent ID prefixes in response data. Set to false when exchanging PAPI data with other APIs. | |
Content-Type | string | ||
Accept | string |