curl --request PATCH \
--url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "claim",
"status": "closed"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440001",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"type": "claim",
"status": "closed",
"referenceId": "CLM-2025-001",
"coverageTypeId": "general_liability",
"policyId": "550e8400-e29b-41d4-a716-446655440100",
"insuredIds": [
"550e8400-e29b-41d4-a716-446655440200"
],
"createdAt": "2025-01-15T10:30:00.000Z",
"createdBy": "google-oauth2|123456789",
"updatedAt": "2025-01-20T09:00:00.000Z",
"data": {
"eventDescription": "Vehicle accident at intersection",
"claimAmount": "75000"
}
}Update Event
Updates an existing event. Only send fields you want to change.
Required fields in request body:
type- Event type (required for permission resolution)
Optional update fields:
status- Update event statuscoverageTypeId- Update coverage typepolicyId- Update associated policy (usenullto remove)insuredIds- Replace associated insuredsdata- Update custom entity data (merged with existing)
Required permission: claim:update or incident:update (depending on type in request body)
curl --request PATCH \
--url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "claim",
"status": "closed"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440001",
"companyId": "550e8400-e29b-41d4-a716-446655440000",
"type": "claim",
"status": "closed",
"referenceId": "CLM-2025-001",
"coverageTypeId": "general_liability",
"policyId": "550e8400-e29b-41d4-a716-446655440100",
"insuredIds": [
"550e8400-e29b-41d4-a716-446655440200"
],
"createdAt": "2025-01-15T10:30:00.000Z",
"createdBy": "google-oauth2|123456789",
"updatedAt": "2025-01-20T09:00:00.000Z",
"data": {
"eventDescription": "Vehicle accident at intersection",
"claimAmount": "75000"
}
}Authorizations
API key authentication. Include your API key in the Authorization header.
Path Parameters
Company identifier
Event identifier
Body
Type of event (claim or incident)
claim, incident Status of the event
open, closed Update coverage type
Update associated lawsuit (null to remove)
Update associated policy (null to remove)
Update associated insureds (replaces existing)
Update custom entity data (merged with existing)
Show child attributes
Show child attributes
Response
Event updated successfully
An event (claim or incident) in the system
Event identifier
Company identifier
Type of event (claim or incident)
claim, incident Status of the event
open, closed Human-readable reference ID for the event
"CLM-2025-001"
Coverage type identifier for this event
"general_liability"
Associated lawsuit ID (null if no lawsuit exists for this event)
Associated policy ID (null if not linked to a policy)
IDs of insureds associated with this event
When the event was created (ISO 8601)
User ID who created the event (null if not tracked)
When the event was last updated (ISO 8601), or null if never updated
Custom entity data with field keys mapped to values. Returns null when no custom data exists.
Show child attributes
Show child attributes
{
"eventDescription": "Vehicle accident at intersection",
"claimAmount": "50000",
"dateOfLoss": "2025-01-10"
}
Was this page helpful?