---
title: "Update policy"
method: PATCH
path: "/cases/{case_id}/life-insurance/{policy_id}"
tags: ["Life Insurance"]
---

# Update policy

`PATCH /cases/{case_id}/life-insurance/{policy_id}`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/life-insurance/{policy_id}`
- Auth: none declared

## Request body

- LifeInsurancePolicyWrite
  - `policy_type` 'term_life' | 'whole_life' | 'universal_life' | 'variable_life' | 'group_employer' | 'group_government' | 'supplemental' | 'accidental_death' | 'annuity_with_death_benefit', required
  - `carrier_name` string, required
  - `policy_number` string: Full policy number.
  - `status` 'active' | 'inactive' | 'lapsed' | 'claimed' | 'paid_out' | 'denied' | 'unknown'
  - `death_benefit` number, double
  - `cash_value` number, double
  - `beneficiaries` object[]
    - `name` string
    - `relationship` string
    - `percentage_share` number, double
    - `designation` 'primary' | 'contingent'
    - `is_irrevocable` boolean
  - `employer_name` string
  - `claim_status` 'not_filed' | 'filed' | 'under_review' | 'approved' | 'paid' | 'denied'
  - `claim_filed_date` string, date
  - `institution_contact_id` string
  - `notes` string

## Response `200`

Policy updated.

- object
  - `data` LifeInsurancePolicy
    - `id` string
    - `case_id` string
    - `policy_type` 'term_life' | 'whole_life' | 'universal_life' | 'variable_life' | 'group_employer' | 'group_government' | 'supplemental' | 'accidental_death' | 'annuity_with_death_benefit'
    - `carrier_name` string
    - `policy_number` string, nullable: Masked in responses (last 4 digits only).
    - `status` 'active' | 'inactive' | 'lapsed' | 'claimed' | 'paid_out' | 'denied' | 'unknown'
    - `death_benefit` number, double, nullable: Face value / death benefit amount.
    - `cash_value` number, double, nullable: Accumulated cash value (whole/universal life only).
    - `beneficiaries` object[]
      - `name` string
      - `relationship` string
      - `percentage_share` number, double
      - `designation` 'primary' | 'contingent'
      - `is_irrevocable` boolean
    - `premium_status` 'current' | 'past_due' | 'waived' | 'paid_up' | 'null', nullable
    - `employer_name` string, nullable: For group/employer-provided policies.
    - `claim_status` 'not_filed' | 'filed' | 'under_review' | 'approved' | 'paid' | 'denied' | 'null', nullable
    - `claim_filed_date` string, date, nullable
    - `claim_paid_date` string, date, nullable
    - `claim_paid_amount` number, double, nullable
    - `institution_contact_id` string, nullable
    - `notes` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404`: Resource not found.
- `422`: Request validation failed.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)