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

# List groups

> Lists the organization's groups synced from its identity provider (via directory sync), ordered by name, with the emails of their active members. Groups are managed in the identity provider and are read-only here. Requires the `manage:read` scope.



## OpenAPI

````yaml https://api.edenai.run/v2/info/splitted-schema/management_api/openapi.json get /v3/manage/groups/
openapi: 3.0.3
info:
  title: Organization Management
  version: '2.0'
  description: Your project description
servers:
  - url: https://api.edenai.run
security: []
paths:
  /v3/manage/groups/:
    get:
      tags:
        - Groups
      summary: List groups
      description: >-
        Lists the organization's groups synced from its identity provider (via
        directory sync), ordered by name, with the emails of their active
        members. Groups are managed in the identity provider and are read-only
        here. Requires the `manage:read` scope.
      operationId: manage_groups_list
      parameters:
        - name: limit
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: offset
          required: false
          in: query
          description: The initial index from which to return the results.
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedManageGroupList'
          description: ''
      security:
        - ManagementKeyAuth: []
components:
  schemas:
    PaginatedManageGroupList:
      type: object
      required:
        - results
        - limit
        - offset
        - total_count
        - next
        - previous
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/ManageGroup'
        limit:
          type: integer
          example: 25
          description: Page size applied to this response (max 100).
        offset:
          type: integer
          example: 0
          description: Index of the first item in this page.
        total_count:
          type: integer
          example: 123
          description: Total number of items across all pages.
        next:
          type: string
          nullable: true
          format: uri
          example: https://api.edenai.run/v3/manage/members/?limit=25&offset=25
          description: Absolute URL of the next page, or null on the last page.
        previous:
          type: string
          nullable: true
          format: uri
          description: Absolute URL of the previous page, or null on the first page.
    ManageGroup:
      type: object
      description: >-
        A group synced from your identity provider. `external_group_id` is the
        group's id in the

        identity provider and the identifier used in
        `/manage/groups/{external_group_id}` URLs;

        `members` lists the emails of the group's active members.
      properties:
        external_group_id:
          type: string
          maxLength: 255
        name:
          type: string
          maxLength: 255
        members:
          type: array
          items:
            type: string
            format: email
          readOnly: true
      required:
        - external_group_id
        - members
        - name
  securitySchemes:
    ManagementKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: >-
        A management key (created from the organization dashboard or with `POST
        /v3/manage/auth-keys`), sent as `Authorization: Bearer
        <management_key>`. Inference API keys (`sk-eden...`) are not accepted on
        these endpoints.

````