Bulk activate a set of properties
POST https://{{host}}/papi/v1/bulk/activations
Bulk activate a set of property versions. Alternately, perform a bulk fallback to the previous activation within an hour of the previous bulk activation. Base the set of versions to activate on the results of a bulk patch operation, which you use in this operation's request. This operation launches an asynchronous process to update properties. To check its progress, run the List bulk-activated properties operation, whose link is available in the Location header or bulkActivationLink member of this operation's response. See Bulk Search and Update for overall 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
{"activatePropertyVersions"=>[{"network"=>"STAGING", "note"=>"Some activation note", "propertyId"=>"prp_1", "propertyVersion"=>2}, {"network"=>"STAGING", "note"=>"Sample activation", "notifyEmails"=>["someoneElse@somewhere.com"], "propertyId"=>"prp_15", "propertyVersion"=>3}, {"acknowledgeAllWarnings"=>false, "acknowledgeWarnings"=>["msg_123", "msg_234"], "network"=>"PRODUCTION", "note"=>"created by xyz", "propertyId"=>"prp_3", "propertyVersion"=>11}], "defaultActivationSettings"=>{"acknowledgeAllWarnings"=>true, "fastPush"=>true, "notifyEmails"=>["you@example.com", "them@example.com"], "useFastFallback"=>false}}
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 |