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

# delete-integration

> Archive an integration.



## OpenAPI

````yaml /api-reference/membrane-api.json delete /integrations/{id}
openapi: 3.0.0
info:
  title: Membrane API
  description: API documentation for Membrane Engine
  version: '1.0'
  contact: {}
servers:
  - url: https://api.getmembrane.com
security:
  - bearer: []
tags: []
paths:
  /integrations/{id}:
    delete:
      summary: delete-integration
      description: Archive an integration.
      operationId: deleteIntegration
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            description: Integration id, uuid, or key
      responses:
        '200':
          description: Archive an integration.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                    description: >-
                      Display name. Always present in API responses (filled by
                      API if not set on create).
                  uuid:
                    description: >-
                      Stable unique identifier (UUID). Can be provided on
                      create; otherwise generated. Must be unique across
                      elements of this type.
                    type: string
                  key:
                    description: >-
                      Stable key for referencing the element (e.g. in
                      selectors). Unique per (parent, integration) scope.
                      Generated from name if not provided on create.
                    type: string
                  description:
                    description: Optional human-readable description.
                    type: string
                  meta:
                    description: Optional key-value metadata.
                    type: object
                    additionalProperties: {}
                  state:
                    description: >-
                      Current lifecycle or health state (e.g. READY,
                      SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the
                      engine during setup and validation.
                    type: string
                    enum:
                      - BUILDING
                      - CLIENT_ACTION_REQUIRED
                      - CONFIGURATION_ERROR
                      - SETUP_FAILED
                      - READY
                      - DISCONNECTING
                  errors:
                    description: Validation or setup errors when state is not READY.
                    type: array
                    items:
                      type: object
                  revision:
                    description: >-
                      Opaque revision token; changes on each update. Used for
                      optimistic concurrency.
                    type: string
                  createdAt:
                    description: ISO date when the element was created.
                    type: string
                  updatedAt:
                    description: ISO date when the element was last updated.
                    type: string
                  archivedAt:
                    type: string
                  isDeactivated:
                    type: boolean
                  isReadOnly:
                    description: >-
                      When true, the element cannot be modified (e.g. published
                      package elements or elements from another workspace).
                    type: boolean
                  logoUri:
                    description: >-
                      Resolved app logo for this element (integration ->
                      connector -> external app -> favicon).
                    type: string
                  connectorId:
                    type: string
                  connectorVersion:
                    type: string
                  oAuthCallbackUri:
                    type: string
                  parameters: {}
                  hasMissingParameters:
                    type: boolean
                  hasDocumentation:
                    type: boolean
                  hasUdm:
                    type: boolean
                  isTest:
                    type: boolean
                  externalAppId:
                    type: string
                  appUuid:
                    description: '[INTERNAL] Deprecated: Use externalAppId instead'
                    type: string
                  authType:
                    type: string
                    enum:
                      - integration-app-token
                      - membrane-token
                      - oauth2
                      - oauth1
                      - client-credentials
                      - proxy
                  optionsConfig:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        disabled:
                          type: boolean
                        parameters:
                          type: object
                          additionalProperties: {}
                      additionalProperties: false
                  spec: {}
                  appUri:
                    type: string
                  isCustom:
                    description: >-
                      Marks integrations derived from workspace-owned,
                      non-public connectors or external apps.
                    type: boolean
                required:
                  - name
                additionalProperties: false
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````