Update Event

Updates a Field Model V1 event. The request body is a flat JSON object with field referenceIds as keys — the same shape as the create request.

This is a full replacement of the event’s field data, not a merge. Include all fields you want the event to have after the update.

The eventType field is required in the body for permission resolution.

Required permission: claim:update or incident:update (determined by eventType)

PUT /api/v1/external/companies/{companyId}/events/{eventId}

Update Event

cURL

curl --request PUT \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/events/{eventId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventType": "Claim",
  "eventCoverageType": "Professional Liability",
  "eventInsureds": [
    "550e8400-e29b-41d4-a716-446655440200"
  ],
  "lossDescription": "Updated - severe water damage to building",
  "lossDate": {
    "date": "2025-01-10",
    "timezone": "America/New_York"
  }
}
'

200

success

{
  "id": "550e8400-e29b-41d4-a716-446655440300",
  "companyId": "550e8400-e29b-41d4-a716-446655440000",
  "policyId": "550e8400-e29b-41d4-a716-446655440100",
  "fieldModelV1Data": {
    "eventType": "Claim",
    "eventCoverageType": "Professional Liability",
    "eventPolicy": "550e8400-e29b-41d4-a716-446655440100",
    "lossDescription": "Updated - severe water damage to building",
    "lossDate": {
      "date": "2025-01-10",
      "timezone": "America/New_York"
    }
  },
  "createdAt": "2025-01-15T10:30:00.000Z",
  "createdBy": "google-oauth2|123456789",
  "updatedAt": "2025-01-20T14:00:00.000Z",
  "updatedBy": "google-oauth2|987654321"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

companyId · string<uuid> · required

Company identifier

eventId · string<uuid> · required

Event identifier

Body

application/json

Flat JSON object with field referenceIds as keys (full replacement)

Response

200

application/json

Event updated successfully

A Field Model V1 event entity with dynamic field data.

id · string<uuid> · required

Event identifier

companyId · string<uuid> · required

Company identifier

fieldModelV1Data · object · required

Dynamic field data for the event. Keys are field referenceIds defined in the company's field configuration. Includes base fields like eventType, eventCoverageType, and eventPolicy (the Join field that stores the associated policy ID, also surfaced at the top level as policyId) as well as any custom fields.

policyId · string<uuid> | null

Associated policy ID. Convenience field surfaced at the top level for backwards compatibility — the value is read from fieldModelV1Data.eventPolicy, where it is stored as a Join: Policy field.

createdAt · string<date-time> | null

When the event was created

createdBy · string | null

User ID who created the event

updatedAt · string<date-time> | null

When the event was last updated

updatedBy · string | null

User ID who last updated the event