## Update an insurance record

`PUT https://getkollek.com/api/copies/{copy}/insurance-records/{insuranceRecord}`

Update an insurance record. Every field is replaced, so send the ones you want to keep along with the ones you are changing.

**Permissions:** Owners and editors. Viewers get a 404 response.

### Path parameters

- `copy` (integer, required): The ID of the copy the insurance record belongs to.
- `insuranceRecord` (integer, required): The ID of the insurance record.

### Body parameters

- `provider` (string, required): The insurer that holds the coverage.
- `insured_value` (integer, required): What the copy is insured for, in the smallest currency unit (e.g. cents).
- `status` (string, optional): Where the coverage stands. One of active, expired, cancelled or pending. Defaults to active. A copy may hold only one active record per policy number at a time.
- `currency_code` (string, optional): The three letter currency code the insured value is expressed in. Defaults to the currency of the collection.
- `policy_number` (string, optional): The policy number the coverage sits under.
- `coverage_type` (string, optional): What kind of coverage this is, such as a scheduled item or blanket contents.
- `deductible_amount` (integer, optional): The deductible, in the smallest currency unit.
- `deductible_currency_code` (string, optional): The three letter currency code the deductible is expressed in. Defaults to the currency of the insured value.
- `starts_at` (string, optional): The date the coverage begins, in YYYY-MM-DD format.
- `ends_at` (string, optional): The date the coverage ends, in YYYY-MM-DD format. Leave it out for ongoing coverage.
- `is_scheduled_item` (boolean, optional): Whether the copy is individually listed on the policy rather than covered under blanket contents.
- `contact_name` (string, optional): The broker or agent for the policy.
- `contact_email` (string, optional): The email of the broker or agent.
- `contact_phone` (string, optional): The phone number of the broker or agent.
- `note` (string, optional): A free form note about the coverage.

**Returns:** The updated insurance record object.

### Example request

```bash
curl https://getkollek.com/api/copies/1/insurance-records/1 \
  -X PUT \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "Collectibles Insurance Services",
    "insured_value": "45000",
    "status": "active",
    "currency_code": "USD",
    "policy_number": "CIS-88231",
    "coverage_type": "Scheduled item",
    "deductible_amount": "10000",
    "deductible_currency_code": "USD",
    "starts_at": "2024-01-01",
    "ends_at": "2025-01-01",
    "is_scheduled_item": "true",
    "contact_name": "Dana Whitfield",
    "contact_email": "dana@cisinsurance.com",
    "contact_phone": "+1 888 837 9537",
    "note": "On the fine-collectibles rider."
}'
```

### Example response

`Status: 200`

```json
{
    "data": {
        "type": "insurance_record",
        "id": "1",
        "attributes": {
            "copy_id": "1",
            "provider": "Collectibles Insurance Services",
            "policy_number": "CIS-88231",
            "coverage_type": "Scheduled item",
            "insured_value": 45000,
            "currency_code": "USD",
            "deductible_amount": 10000,
            "deductible_currency_code": "USD",
            "starts_at": 1704067200,
            "ends_at": null,
            "status": "active",
            "is_scheduled_item": true,
            "contact_name": "Dana Whitfield",
            "contact_email": "dana@cisinsurance.com",
            "contact_phone": "+1 888 837 9537",
            "note": null,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/copies/1/insurance-records/1"
        }
    }
}
```