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

# Delete employee group

> Deletes an employee group. Fails with 400 if the group is currently assigned to an employee or an expense category. Returns 403 when the authenticated user is not an administrator of the organization. Returns 404 when the employee group does not exist, or belongs to a different organization.




## OpenAPI

````yaml /openapi/findity-admin-api.json delete /organizations/{organizationId}/employeegroups/{employeeGroupId}
openapi: 3.1.0
info:
  title: Findity Admin API
  description: Findity Admin API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/admin
  - url: https://api.findity.com/api/v1/admin
security:
  - bearerAuth: []
paths:
  /organizations/{organizationId}/employeegroups/{employeeGroupId}:
    delete:
      tags:
        - Employee Groups
      summary: Delete employee group
      description: >
        Deletes an employee group. Fails with 400 if the group is currently
        assigned to an employee or an expense category. Returns 403 when the
        authenticated user is not an administrator of the organization. Returns
        404 when the employee group does not exist, or belongs to a different
        organization.
      operationId: adminDeleteEmployeeGroup
      parameters:
        - name: organizationId
          in: path
          required: true
          description: |
            String. The organization's internal ID (32-character hex string).
          schema:
            type: string
            example: 11adfe2a080040e3892ffb89c21ec44e
        - name: employeeGroupId
          in: path
          required: true
          description: >
            String (32-character hex string). The internal ID of the employee
            group to delete, as returned in the `id` field of the list, create,
            and update responses.
          schema:
            type: string
            example: 3f2a9c1b8e7d4a6f9b0c1d2e3f4a5b6c
      responses:
        '204':
          description: No Content — employee group successfully deleted
        '400':
          description: Bad request — employee group is currently in use
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Error'
              examples:
                Employee group in use:
                  value:
                    result: error
                    code: EMPLOYEE_GROUP_IN_USE
                    description: >-
                      This group is assigned to an employee or category and
                      cannot be deleted.
        '403':
          description: >-
            Forbidden — the authenticated user is not an administrator of the
            organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Error'
              examples:
                Permission denied:
                  value:
                    result: error
                    description: Permission denied
        '404':
          description: >-
            Not found — employee group does not exist, or belongs to a different
            organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              examples:
                Employee group not found:
                  value:
                    result: error
                    code: EMPLOYEE_GROUP_NOT_FOUND
                    description: Employee group not found
components:
  schemas:
    400Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
    403Error:
      type: object
      properties:
        result:
          type: string
        description:
          type: string
      example:
        result: error
        description: Not allowed
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
      example:
        result: error
        code: ORGANIZATION_NOT_FOUND
        description: 'Failed to get organization for id: {orgId}'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````