Account jobs and policies
Querying for job and policy information
To retrieve a list of jobs or policies for a given account, use the following endpoints:
- GET
/account/v1/accounts/{accountId}/jobs
- GET
/account/v1/accounts/{accountId}/policies
Moving policies
In some situations, you may want to move a policy from a source account to a target account. For example, this could be necessary if the policy was erroneously associated with the wrong account.
To move a policy to a given target account, use the following endpoint:
- POST
/account/v1/accounts/{accountId}/move-policies
The POST is executed from the target account (the account that will own the policy
moving forward). The request object requires a request payload that specifies the
IDs of the policies to move to the target account. These IDs are specified in a
policies
array.
For example, the following call moves the policies with IDs pc:1021 and pc:1099 to account pc:477.
POST /account/v1/accounts/pc:477/move-policies
{
"data": {
"attributes": {
"policies": [
{
"id": "pc:1021"
},
{
"id": "pc:1099"
}
]
}
}
}
The "move policies" functionality has the following limitations:
- You cannot move an archived policy.
- You cannot move multiple policies at one time from different source accounts. Every group of moved policies must be from the same source account going to the same target account.
- You cannot move a policy to an account that could not normally own that type of policy. (For example, you cannot move a Personal Auto policy to an account that is a company.)
- All InsuranceSuite applications have a Messaging infrastructure used to send messages asynchronously to third-party applications. You cannot move a policy if it has any pending messages associated with it.