Create Exposure Type

Creates a new exposure type for the company and adds it to the company’s enabled exposure types.

Exposure types define the categories of insured entities a company can manage (e.g., “Franchise Truck Dealer”, “Auto”, “Company”).

The value must be unique within the company. Attempting to create a duplicate value returns a validation error.

Required permission: company:update

POST /api/external/companies/{companyId}/exposure-types

Create Exposure Type

cURL

curl --request POST \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/exposure-types \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": "franchise_truck_dealer",
  "label": "Franchise Truck Dealer"
}
'

201

success

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

Authorizations

Authorization · string · header · required

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

Path Parameters

companyId · string<uuid> · required

Company identifier

Body

application/json

Request body for creating an exposure type

value · string · required

Unique identifier for this exposure type within the company. Typically a snake_case string (e.g., "franchise_truck_dealer").

Minimum string length: 1

label · string · required

Human-readable display name for the exposure type

Minimum string length: 1

Response

201

application/json

Exposure type created successfully

id · string<uuid>

The ID of the created exposure type