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

# Deprovision a group

> Deletes the group along with its memberships and every role binding granted through it, so the access it carried is revoked with it. The members themselves keep their organization membership and any access they hold directly.



## OpenAPI

````yaml DELETE /api/scim/v2/Groups/{id}
openapi: 3.1.0
info:
  title: LangWatch API
  version: 1.0.0
  description: LangWatch openapi spec
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/scim/v2/Groups/{id}:
    delete:
      tags:
        - SCIM
      summary: Deprovision a group
      description: >-
        Deletes the group along with its memberships and every role binding
        granted through it, so the access it carried is revoked with it. The
        members themselves keep their organization membership and any access
        they hold directly.
      operationId: scimDeleteGroup
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The LangWatch group id.
      responses:
        '204':
          description: Deprovisioned. No body.
        '401':
          description: >-
            The Authorization header is missing, is not a bearer token, or names
            a token this deployment does not know.
          content:
            application/scim+json:
              schema:
                type: object
                properties:
                  schemas:
                    type: array
                    items:
                      type: string
                    description: The SCIM schema URNs this resource conforms to.
                  status:
                    type: string
                    description: The HTTP status, as a string.
                  detail:
                    type: string
        '403':
          description: >-
            The token is valid but the organization's plan no longer includes
            SCIM provisioning. Entitlement is checked on every call, so a
            directory connection stops the moment the Enterprise plan lapses.
          content:
            application/scim+json:
              schema:
                type: object
                properties:
                  schemas:
                    type: array
                    items:
                      type: string
                    description: The SCIM schema URNs this resource conforms to.
                  status:
                    type: string
                    description: The HTTP status, as a string.
                  detail:
                    type: string
        '404':
          description: No such group in this organization.
          content:
            application/scim+json:
              schema:
                type: object
                properties:
                  schemas:
                    type: array
                    items:
                      type: string
                    description: The SCIM schema URNs this resource conforms to.
                  status:
                    type: string
                    description: The HTTP status, as a string.
                  detail:
                    type: string
      security:
        - scim_bearer: []
components:
  securitySchemes:
    project_api_key:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: >-
        Project API key for sending traces and accessing project-scoped
        resources. Format: sk-lw-... (no underscore). Obtain one by creating a
        project via the Admin API or the LangWatch UI.
    scim_bearer:
      type: http
      scheme: bearer
      description: >-
        SCIM token for one organization's directory connection, created with
        POST /api/scim-tokens or in Settings > SCIM. It authenticates
        provisioning calls only, and stops working if the organization's
        Enterprise plan lapses.

````