> ## 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.

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

# List groups

> List all groups for the organization



## OpenAPI

````yaml GET /api/v1/groups
openapi: 3.1.0
info:
  title: LangWatch API
  description: LangWatch openapi spec
  version: 1.0.0
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/v1/groups:
    get:
      tags:
        - Groups
      description: List all groups for the organization
      operationId: getApiGroups
      parameters:
        - in: query
          name: page
          schema:
            default: 1
            type: integer
            exclusiveMinimum: 0
            maximum: 9007199254740991
        - in: query
          name: limit
          schema:
            default: 50
            type: integer
            exclusiveMinimum: 0
            maximum: 1000
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          minLength: 1
                        name:
                          type: string
                          minLength: 1
                        slug:
                          type: string
                          minLength: 1
                        externalId:
                          type:
                            - string
                            - 'null'
                        scimSource:
                          type:
                            - string
                            - 'null'
                        createdAt:
                          type: string
                          format: date-time
                        memberCount:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        bindings:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                minLength: 1
                              role:
                                type: string
                                enum:
                                  - ADMIN
                                  - MEMBER
                                  - VIEWER
                                  - CUSTOM
                              customRoleId:
                                type:
                                  - string
                                  - 'null'
                              customRoleName:
                                type:
                                  - string
                                  - 'null'
                              scopeType:
                                type: string
                                enum:
                                  - ORGANIZATION
                                  - TEAM
                                  - PROJECT
                              scopeId:
                                type: string
                                minLength: 1
                            required:
                              - id
                              - role
                              - customRoleId
                              - customRoleName
                              - scopeType
                              - scopeId
                            additionalProperties: false
                      required:
                        - id
                        - name
                        - slug
                        - externalId
                        - scimSource
                        - createdAt
                        - memberCount
                        - bindings
                      additionalProperties: false
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      limit:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      total:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                    required:
                      - page
                      - limit
                      - total
                    additionalProperties: false
                required:
                  - data
                  - pagination
                additionalProperties: false
      security:
        - admin_api_key: []
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.
    admin_api_key:
      type: http
      scheme: bearer
      description: >-
        Admin API key for organization-level operations (managing projects, API
        keys). Create one in Settings > API Keys or via POST /api/api-keys.
        Format: sk-lw-{id}_{secret}.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.