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

# Remove a group from a custom workspace

> ⚠️ **ALPHA ENDPOINT** - This endpoint is in alpha and subject to breaking changes. Use with caution in production environments.

Remove a group from a custom workspace you own. The authenticated user must be an owner of the workspace and belong to the same company as the workspace. Only CUSTOM workspaces allow group removal. Cannot remove the only remaining owner group from the workspace.



## OpenAPI

````yaml /api-reference/openapi-v3.yaml delete /api/v3/workspaces/{id}/members/groups/{group_id}
openapi: 3.0.3
info:
  title: Paradigm API
  version: xenial-xerus (v3)
  description: >-
    A versatile and adaptable tool designed to integrate Generative AI into your
    applications
servers:
  - url: https://paradigm.lighton.ai
security: []
tags:
  - name: Agents
    description: Operations about agents
  - name: Threads
    description: Operations about agents conversation threads
  - name: Tools
    description: Operations about native tools
  - name: Models
    description: Operations about AI models
  - name: MCP
    description: Operations about MCP servers
  - name: Sources
    description: Operations about sources used by agents conversation threads
  - name: Artifacts
    description: Operations about artifacts generated by agents conversation threads
  - name: Agent
    description: >-
      Operations about agents (deprecated). Please use the 'Agents' API
      component instead.
  - name: Files
    description: Operations about files
  - name: Files Processing
    description: Operations about files processing
  - name: Tags
    description: Operations about tags
  - name: Workspaces
    description: Operations about workspaces
  - name: Users
    description: Operations about users
  - name: User Groups
    description: Operations about user groups
  - name: Companies
    description: Operations about companies
  - name: SCIM
    description: Operations about SCIM
paths:
  /api/v3/workspaces/{id}/members/groups/{group_id}:
    delete:
      tags:
        - Workspaces
      summary: Remove a group from a custom workspace
      description: >-
        ⚠️ **ALPHA ENDPOINT** - This endpoint is in alpha and subject to
        breaking changes. Use with caution in production environments.


        Remove a group from a custom workspace you own. The authenticated user
        must be an owner of the workspace and belong to the same company as the
        workspace. Only CUSTOM workspaces allow group removal. Cannot remove the
        only remaining owner group from the workspace.
      operationId: api_v3_workspaces_members_groups_destroy
      parameters:
        - in: path
          name: group_id
          schema:
            type: integer
          required: true
        - in: path
          name: id
          schema:
            type: integer
          required: true
      responses:
        '204':
          description: Group removed from workspace successfully
        '401':
          description: Unauthenticated
        '403':
          description: Unauthorized
        '404':
          description: Not Found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your auth token.

````