Update Quote

Updates a Field Model V1 quote. This is a full replacement of the quote’s policy and exposure data.

The policy object is merged with existing lifecycle fields (the system preserves quoteType, quoteStatus, quoteNumber, quoteBindErrors, quoteSubmissionId). The exposures array fully replaces the existing exposures.

Lifecycle fields are rejected with a 400 error if included in the request body.

Required permission: company.quote:update

PUT /api/v1/external/companies/{companyId}/quotes/{quoteId}

Update Quote

cURL

curl --request PUT \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/quotes/{quoteId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "policy": {
    "effectiveDate": "2025-01-01",
    "premium": 18000
  },
  "exposures": [
    {
      "exposureName": "Acme Corp",
      "employeeCount": 175
    }
  ]
}
'

200

success

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "companyId": "550e8400-e29b-41d4-a716-446655440000",
  "submissionId": "550e8400-e29b-41d4-a716-446655440010",
  "policyId": null,
  "policy": {
    "effectiveDate": "2025-01-01",
    "premium": 18000,
    "quoteType": "New Business",
    "quoteStatus": "in_progress",
    "quoteNumber": "Q-2025-001"
  },
  "exposures": [
    {
      "exposureName": "Acme Corp",
      "employeeCount": 175
    }
  ],
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-20T14:00:00.000Z",
  "createdBy": "google-oauth2|123456789"
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

quoteId · string<uuid> · required

Quote identifier

Body

application/json

policy · object · required

Policy-level custom field data (lifecycle fields rejected)

exposures · object[] · required

Array of exposure objects (full replacement)

Response

200

application/json

Quote updated successfully

A Field Model V1 quote with policy and exposure data.

id · string<uuid> · required

Quote identifier

companyId · string<uuid> · required

Company identifier

submissionId · string<uuid> · required

Associated submission ID

policy · object · required

Policy-level custom field data. Keys are field referenceIds defined in the company's field configuration. Includes lifecycle fields (quoteType, quoteStatus, quoteNumber, quoteBindErrors, quoteSubmissionId) which are read-only and system-managed.

exposures · object[] · required

Array of exposure objects, each containing custom field data with field referenceIds as keys.

createdAt · string<date-time> · required

When the quote was created

policyId · string<uuid> | null

Associated policy ID (null until quote is bound)

updatedAt · string<date-time> | null

When the quote was last updated

createdBy · string | null

User ID who created the quote