> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiinsurance.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
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:

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440003"
}
```