curl --request PATCH \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/entities/{entityType}/{entityId} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"exposureName": "Acme Corp Headquarters"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440301"
}Update Entity
Updates a {entityType} entity. The request body is a flat JSON object with
field referenceIds as keys — the same shape as create.
Provided fields are merged onto the existing fieldModelV1Data; a key
set to null clears that field. Fields you omit are left unchanged.
Updates are PATCH only — never PUT. A PUT to this resource is
rejected with 405 Method Not Allowed and an Allow: PATCH header (the
handler does a partial merge, which is PATCH semantics; PUT would imply full
replacement, which these endpoints do not do).
A bound quote is closed to updates. Once quoteStatus is bound this
endpoint refuses the whole request with 409 QuoteBoundImmutable, whatever
the body holds — the bound policy is never re-read from the quote, so an
accepted edit would only widen a divergence between them. The 409 body
carries referencingPolicy. Endorse that policy to change what is in force,
or create a new quote to model a variation.
Required permission: <resource>.edit for the entity’s resource (event.edit,
exposure.edit, quote.edit, submission.edit, person.edit,
organization.edit), derived from the path’s
{entityType}. See
Permissions.
curl --request PATCH \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/entities/{entityType}/{entityId} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"exposureName": "Acme Corp Headquarters"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440301"
}Authorizations
API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.
Path Parameters
Company identifier
Field Model V1 entity type (lowercase kebab-case URL slug). One of the six
CRUD entity types: event, exposure, quote, submission, person,
organization. policy is NOT valid here — Policy has no generic CRUD (its
writes go through the policy transaction endpoints), though it does have a
read-only /configuration schema.
event, exposure, quote, submission, person, organization Entity identifier
Body
Flat JSON object with field referenceIds as keys (merged onto existing data)
Response
Entity updated successfully
The ID of the updated entity