Update Expected Totals

Updates the expected total (reserve) for a transaction category on a Field Model V1 event.

This endpoint is used to set or update reserve amounts for categories that support reserves.

Unlike the legacy expected-totals endpoint, this endpoint resolves the event type from fieldModelV1Data.eventType rather than the internal type column. Use this endpoint for events created via the V1 API.

Important: Amounts are in dollars (not cents) for this endpoint.

Required permission: claim:update or incident:update (depending on event type)

PATCH /api/v1/external/companies/{companyId}/events/{eventId}/financials/expected-totals

cURL

updateIndemnityReserve

curl --request PATCH \ --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/events/{eventId}/financials/expected-totals \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data ' { "type": "claim", "categoryId": "indemnity_invoice", "expectedTotal": 15000 } '

200

success

{ "eventId": "550e8400-e29b-41d4-a716-446655440001", "categoryId": "indemnity_invoice", "expectedTotal": 15000, "reserves": 10000 }

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

Request body for updating expected totals on an event

type · enum<string> · required

Type of event (claim or incident)

Available options: claim, incident

categoryId · string · required

Transaction category identifier (must support reserves)

expectedTotal · number · required

Expected total amount in dollars (not cents)

Required range: x >= 0

asOfDate · string<date>

Historical date for the update (YYYY-MM-DD, optional)

Response

200

application/json

Expected total updated successfully

Response from updating expected totals

eventId · string<uuid>

Event identifier

categoryId · string

Transaction category identifier

expectedTotal · number | null

Updated expected total in dollars (null if not found)

reserves · number | null

Reserve amount for the category in dollars (null if not applicable)