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

# Delete an engagement

> Delete an engagement



## OpenAPI

````yaml delete /v1/integrations/engagements/{id}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Swagger API
servers:
  - url: https://functions.siro.ai/api-externalApi
    description: Siro API external API endpoint
security: []
externalDocs:
  description: View the raw OpenAPI Specification in JSON format
  url: /swagger.json
paths:
  /v1/integrations/engagements/{id}:
    delete:
      summary: Delete an engagement
      description: Delete an engagement
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
        - schema:
            type: string
            enum:
              - internal
              - external
            description: >-
              Specifies whether the id path parameter is an internal engagement
              ID or an external ID from the source system. Defaults to internal.
          required: false
          description: >-
            Specifies whether the id path parameter is an internal engagement ID
            or an external ID from the source system. Defaults to internal.
          name: idType
          in: query
        - schema:
            type: string
            description: >-
              Optional override to specify integration platform if organization
              has multiple integrations. Only used when idType=external.
          required: false
          description: >-
            Optional override to specify integration platform if organization
            has multiple integrations. Only used when idType=external.
          name: integrationPlatform
          in: query
      responses:
        '200':
          description: Delete an engagement
          content:
            application/json:
              schema:
                type: boolean
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Organization API token
      description: >-
        Organization integration token from Siro admin (Person icon → API
        Tokens). Send Authorization: Bearer <organization-api-token>. This is
        not the OAuth access token used with api.siro.ai user-scoped endpoints.
      x-default: <organization-api-token>

````