---
title: "Update Job Insurance"
method: PUT
path: "/jobs/{jobId}/insurance"
tags: ["jobs"]
---

# Update Job Insurance

`PUT /jobs/{jobId}/insurance`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/jobs/{jobId}/insurance`
- Auth: HTTP bearer

This endpoint sets the insurance information for an existing job.
- "Insurance company" section:
  It can be set by ID or by name, but not both.
  The ID should belong to the existing insurance companies. If the name is used it will be assigned to "Other" (active) insurance company.
  Set them as not assigned can be done, just sending both(ID & name) null or empty will do it.
- dateOfLoss & claimFiledDate should be UTC and in ISO 8601 format (suffixed with 'Z').

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Path parameters

- `jobId` string, uuid, required

## Request body

- JobInsurancePut
  - `insuranceCompany` JobInsuranceCompanyPut
    - `insuranceCompanyId` string, uuid, nullable: The insurance company's unique ID is to be set to the job.
    - `insuranceCompanyName` string, nullable: A job can have an insurance company that is not from the list managed in Account Settings. In this case, the 'insuranceCompanyId' should be null. The text will be assigned to the comments field for the 'Other' (active) insurance company.
  - `customInsuranceCompanyName` string: A job can have an Insurance Company that is not from the list managed in Account Settings. In this case, `insuranceCompany` will be null.
  - `damagelocation` string: Where the damage is located.
  - `dateOfLoss` string: The date the damage occurred in UTC.
  - `claimFiled` boolean: Has the claim been filed? Must be true if `claimFiledDate` is populated.
  - `claimFiledDate` string: The date the claim was filed in UTC.
  - `claimNumber` string: The identifier of the insurance claim given by the insurance company.
  - `hasPaperwork` boolean: Is the paperwork for this job collected?

## Response `204`

No Content

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `429`: The rate limit for this operation has been exceeded. Use the RateLimit-* response headers to determine when you can retry.

## Changes

- **2026-11-03** `443924b00f43`: 1 breaking, 1 warning, 6 info
  - the `allOf[#/components/schemas/insurance]/` request property type changed from no type to `object`
  - removed `#/components/schemas/insuranceLink, subschema #2` from the `allOf[#/components/schemas/insurance]/` request property `allOf` list
  - added the new optional request property `allOf[#/components/schemas/insurance]/claimFiled`
  - added the new optional request property `allOf[#/components/schemas/insurance]/claimFiledDate`
  - …4 more

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/jobs/:jobId/insurance/put.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)