Create Exposure

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/exposure \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "exposureName": "Acme Corp HQ",
  "exposureType": "company"
}
'

{
  "id": "550e8400-e29b-41d4-a716-446655440301"
}

Exposures

Create Exposure

Creates an Exposure via the unified entity CRUD pipeline.

The request body is a flat JSON object where keys are field referenceIds from the company’s field configuration. Use the Get Exposure Configuration endpoint to discover available fields and which are required.

The pipeline validates the data (option sets, types, join cardinality), resolves calculated/auto-set values, enforces framework-required fields, inserts, then syncs join relationships. Date fields are objects: { "date": "YYYY-MM-DD", "timezone": "America/New_York" }.

Required permission: company.insured:create

POST

api

external

companies

{companyId}

entities

exposure

Create Exposure

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/exposure \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "exposureName": "Acme Corp HQ",
  "exposureType": "company"
}
'

{
  "id": "550e8400-e29b-41d4-a716-446655440301"
}

Authorizations

Authorization

string

header

required

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

companyId

string<uuid>

required

Company identifier

Body

application/json

Flat JSON object with field referenceIds as keys

Response

Exposure created successfully

string<uuid>

The ID of the created entity

Get Entity Configuration List Exposures

⌘I