Overview

Manage exposure type definitions for your company

Overview

The Exposure Types API lets you manage the categories of insured entities (exposure types) available to a company. Exposure types define what kinds of exposures can be created — for example, “Franchise Truck Dealer”, “Auto”, or “Company”.

Each exposure type has a unique key (used as a programmatic identifier) and a label (displayed in the UI).

API Endpoints

Method	Endpoint	Description
GET	/exposure-types	List all exposure types with optional label filtering
POST	/exposure-types	Create a new exposure type
DELETE	/exposure-types/{exposureTypeId}	Delete an exposure type

Permissions

Action	Permission
List exposure types	company:read
Create exposure type	company:update
Delete exposure type	company:update

Request Properties

Property	Type	Required	Description
value	string	Yes	Unique identifier for the exposure type (e.g., "franchise_truck_dealer")
label	string	Yes	Human-readable display name (e.g., "Franchise Truck Dealer")

Example

curl -X POST \
  https://app.aiinsurance.io/api/external/companies/{companyId}/exposure-types \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "franchise_truck_dealer",
    "label": "Franchise Truck Dealer"
  }'

Response:

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