> ## 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.

# Delete Exposure

> Soft deletes a Field Model V1 exposure by ID.

The exposure will be marked as deleted and will no longer appear in list
operations. Exposures with associated policies, quotes, events, or
transactions cannot be deleted.

**Required permission:** `insured:delete`




## OpenAPI

````yaml /openapi/generated-external-api.yaml delete /api/v1/external/companies/{companyId}/exposures/{exposureId}
openapi: 3.0.3
info:
  title: AI Insurance External API
  description: External API for AI Insurance platform
  version: 1.0.0
  contact:
    email: support@aiinsurance.io
servers:
  - url: https://app.aiinsurance.io
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/v1/external/companies/{companyId}/exposures/{exposureId}:
    delete:
      tags:
        - Field Model Exposures
      summary: Delete Exposure
      description: |
        Soft deletes a Field Model V1 exposure by ID.

        The exposure will be marked as deleted and will no longer appear in list
        operations. Exposures with associated policies, quotes, events, or
        transactions cannot be deleted.

        **Required permission:** `insured:delete`
      operationId: deleteExposureV1
      parameters:
        - $ref: '#/components/parameters/companyId'
        - name: exposureId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The ID of the exposure to delete
      responses:
        '200':
          description: Exposure deleted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: The ID of the deleted exposure
                  deleted:
                    type: boolean
                    description: Confirmation that the exposure was deleted
              examples:
                success:
                  summary: Exposure deleted
                  value:
                    id: 550e8400-e29b-41d4-a716-446655440002
                    deleted: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Exposure not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                exposureNotFound:
                  summary: Exposure not found
                  value:
                    error:
                      code: NOT_FOUND
                      message: Exposure not found
        '409':
          description: Conflict - Exposure has associated entities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                hasAssociations:
                  summary: Exposure has associated entities
                  value:
                    error:
                      code: CONFLICT
                      message: >-
                        This exposure cannot be deleted because it has
                        associated entities.
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    companyId:
      name: companyId
      in: path
      required: true
      schema:
        type: string
        format: uuid
      description: Company identifier
  responses:
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missingApiKey:
              summary: Missing API key
              value:
                error:
                  code: UNAUTHORIZED
                  message: Authorization header is required
            bearerTokenNotAllowed:
              summary: Bearer token used instead of API key
              value:
                error:
                  code: UNAUTHORIZED
                  message: External API endpoints require API key authentication
    Forbidden:
      description: Forbidden - Insufficient permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            insufficientPermissions:
              summary: Insufficient permissions
              value:
                error:
                  code: FORBIDDEN
                  message: Insufficient permissions to perform this action
    InternalServerError:
      description: Internal Server Error - Unexpected error occurred
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            internalError:
              summary: Unexpected server error
              value:
                error:
                  code: INTERNAL_ERROR
                  message: An unexpected error occurred. Please try again later.
  schemas:
    ErrorResponse:
      type: object
      description: Standard error response for all external API endpoints
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Machine-readable error code
              example: VALIDATION_ERROR
            message:
              type: string
              description: Human-readable error message
              example: 'submissionId: Required field is missing'
            details:
              type: array
              description: Additional details for validation errors (field-level errors)
              items:
                type: object
                properties:
                  field:
                    type: string
                    description: The field that caused the error
                    example: submissionId
                  message:
                    type: string
                    description: Description of the field error
                    example: Required field is missing
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key authentication. Include your API key in the Authorization
        header.

````