curl --request PATCH \
--url https://app.aiinsurance.io/api/external/companies/{companyId}/exposures/{exposureId} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "John Smith Jr."
}
'{
"id": "550e8400-e29b-41d4-a716-446655440200",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"name": "John Smith Jr.",
"entityType": "individual",
"phoneNumber": "+1-555-987-6543",
"email": "john.smith@newdomain.com",
"billingEmail": null,
"defaultBrokerId": null,
"createdAt": "2025-01-15T10:30:00.000Z",
"createdBy": "google-oauth2|123456789",
"updatedAt": "2025-01-20T14:00:00.000Z",
"updatedBy": "google-oauth2|987654321"
}Update Exposure
Updates an existing exposure.
All fields are optional - only send fields being changed. Does NOT allow updating entityType or applicationData (rating data).
Required permission: insured:update
curl --request PATCH \
--url https://app.aiinsurance.io/api/external/companies/{companyId}/exposures/{exposureId} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "John Smith Jr."
}
'{
"id": "550e8400-e29b-41d4-a716-446655440200",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"name": "John Smith Jr.",
"entityType": "individual",
"phoneNumber": "+1-555-987-6543",
"email": "john.smith@newdomain.com",
"billingEmail": null,
"defaultBrokerId": null,
"createdAt": "2025-01-15T10:30:00.000Z",
"createdBy": "google-oauth2|123456789",
"updatedAt": "2025-01-20T14:00:00.000Z",
"updatedBy": "google-oauth2|987654321"
}Authorizations
API key authentication. Include your API key in the Authorization header.
Path Parameters
Company identifier
Exposure identifier
Body
Request body for updating an insured
Update insured name
Update phone number
Update email (send null to clear)
Update billing email (send null to clear)
ID of an existing broker to set as default (send null to clear). Use GET /brokers to find valid IDs.
Custom data fields to merge with existing data. Keys must match fields from GET /insureds/configuration for the insured's entityType. Send null for a key to clear it.
Show child attributes
Show child attributes
Response
Exposure updated successfully
Full insured details returned from update operations
Insured identifier
Company identifier
Insured name
Entity type (individual, organization, etc.)
Insured phone number
Insured email address
Billing email address
Default broker ID for this insured
When the insured was created
User who created the insured
When the insured was last updated
User who last updated the insured
Was this page helpful?