List bulk-activated properties
GET https://{{host}}/papi/v1/bulk/activations/:bulkActivationId
List all activations that result from a bulk activation request. Once the overall bulkActivationStatus
is COMPLETE
, check each activation's activationStatus
to confirm it's ACTIVATED
. 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. |
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. | |
Accept | string |
RESPONSES
status: OK
{"activatePropertyVersions":[{"acknowledgeAllWarnings":false,"acknowledgeWarnings":["msg_123","msg_234"],"activationStatus":"NEW","activationSubmitDate":"2023-11-22T09:50:18Z","activationUpdateDate":"2023-11-22T09:50:25Z","fastPush":true,"fatalError":"property id is bad or not accessible","network":"PRODUCTION","note":"created by xyz","notifyEmails":["you@example.com","them@example.com"],"propertyId":"prp_3","propertyVersion":11,"taskStatus":"SUBMISSION_ERROR","useFastFallback":false},{"acknowledgeAllWarnings":true,"activationStatus":"NEW","activationSubmitDate":"2023-11-22T09:50:18Z","activationUpdateDate":"2023-11-22T09:50:25Z","fastPush":true,"fatalError":"property id is bad or not accessible","network":"STAGING","note":"Sample activation note","notifyEmails":["you@example.com","them@example.com"],"propertyId":"prp_1","propertyVersion":2,"taskStatus":"SUBMISSION_ERROR","useFastFallback":false},{"acknowledgeAllWarnings":true,"activationStatus":"NEW","activationSubmitDate":"2023-11-22T09:50:18Z","activationUpdateDate":"2023-11-22T09:50:25Z","fastPush":true,"fatalError":"property id is bad or not accessible","network":"STAGING","note":"Sample activation","notifyEmails":["someoneElse@somewhere.com"],"propertyId":"prp_15","propertyVersion":3,"taskStatus":"SUBMISSION_ERROR","useFastFallback":false}],"bulkActivationId":12345,"bulkActivationStatus":"COMPLETE","bulkActivationSubmitDate":"2023-11-22T09:50:18Z","bulkActivationUpdateDate":"2023-11-22T09:50:25Z","defaultActivationSettings":{"acknowledgeAllWarnings":true,"fastPush":true,"notifyEmails":["you@example.com","them@example.com"],"useFastFallback":false}}