API ReferencePolicy Amendment Intents

Create a new policy amendment intent

Initiates a policy amendment (e.g. adding/removing dependents). The intent coordinates the amendment workflow including dependents sub-intent management, quote generation, employee confirmation, and provider processing.

Authentication

AuthorizationBearer
Authorization header using the Bearer scheme

Path parameters

policy_idstringRequiredformat: "p_.+"

Request

This endpoint expects an object.
amendment_reasonobjectRequired
The reason for the policy amendment.
requested_changeslist of objectsRequired
List of requested changes to the policy.

Response

OK
idstringformat: "pai_.+"

Unique identifier for the policy amendment intent. Prefixed with pai_.

policy_idstringformat: "p_.+"

The policy ID for which the amendment is requested. Prefixed with p_.

statusenum
Current status of the policy amendment intent.
amendment_reasonobject
The reason for the policy amendment.
requested_changeslist of objects
List of requested changes to the policy.
objectstring or null
Object type identifier.
required_actionobject or null

Information about the required action if the intent status is action_required.

pending_confirmationobject or null

Information about the pending confirmation if the intent status is pending_confirmation.

processing_errorobject or null

Information about the processing error if the intent status is processing_error.

Errors