Skip to main content

Remove Coverage

Use the Remove Coverage action to unlink an insurance policy from a patient account.

After successful removal, the platform updates the policy state and returns the updated coverage list.


This screen includes:

  • A header with navigation controls and screen title.
  • Policy cards displaying:
    • Insurer information.
    • Policy number.
    • Coverage period.
    • Policyholders.
    • Policy status.
  • A Remove Policy action for active policies.
  • An Add coverage action..
SDK behavior

Policy removal unlinks the policy from the patient account.
The platform does not delete the policy record.

Workflow​

  1. Open Account > My Coverage.
  2. Select Remove Policy for the target policy.
  3. Confirm the removal action.
  4. The client submits a removal request.
  5. The platform unlinks the policy.
  6. The platform returns the updated policy state.
  7. Update the UI to reflect the removed status.

Post-Removal State​

After removal:

  • The policy remains visible in the list.
  • The status updates to Policy was removed.
  • The policy is no longer eligible for booking or coverage resolution.

Validations​

These rules define policy removal constraints.

ConditionApp behaviorSDK output
Policy is active.Enable remove action.Policy marked as removable.
Policy is already removed.Disable remove action.Policy state indicates removal.
User cancels confirmation.Close dialog and keep policy unchanged.No request sent.
Removal request fails.Display error message.Error response indicating removal failure.

Actions​

These actions define behavior during policy removal.

ConditionApp behaviorSDK output
Load coverage list.Render policy cards.Response with linked policies and states.
Select Remove Policy.Display confirmation dialog.No request sent.
Confirm removal.Submit removal request.Request to unlink policy.
Removal succeeds.Update policy status in UI.Response with updated policy state.
Removal fails.Display error and keep policy unchanged.Error response.
Select Add coverage.Open coverage creation flow.Navigation action.

Endpoint Resources​

Remove Policy Confirmation​

PUT 

/policies/delete

This endpoint returns the confirmation popup configuration for removing a policy.

Remove Policy​

POST 

/policies/delete

This endpoint removes an insurance policy from the user’s coverage by canceling it.