> ## 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 role bindings

> List the organization's role bindings, each naming its principal (user, group or API key), role, scope, and the date its access ends if one was set. Filter by principal or scope; totalCount counts the filtered set. superseded by /api/grants, which answers the same rows as grants.



## OpenAPI

````yaml GET /api/v1/role-bindings
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/role-bindings:
    get:
      tags:
        - Role Bindings
      description: >-
        List the organization's role bindings, each naming its principal (user,
        group or API key), role, scope, and the date its access ends if one was
        set. Filter by principal or scope; totalCount counts the filtered set.
        superseded by /api/grants, which answers the same rows as grants.
      operationId: listRoleBindings
      parameters:
        - in: query
          name: userId
          schema:
            type: string
            minLength: 1
        - in: query
          name: groupId
          schema:
            type: string
            minLength: 1
        - in: query
          name: apiKeyId
          schema:
            type: string
            minLength: 1
        - in: query
          name: scopeType
          schema:
            type: string
            enum:
              - PROJECT
              - TEAM
              - ORGANIZATION
        - in: query
          name: scopeId
          schema:
            type: string
            minLength: 1
        - in: query
          name: offset
          schema:
            type: integer
            minimum: 0
            maximum: 9007199254740991
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 200
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  bindings:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        principal:
                          type: object
                          properties:
                            type:
                              type: string
                              enum:
                                - user
                                - group
                                - apiKey
                            id:
                              type: string
                            name:
                              type:
                                - string
                                - 'null'
                          required:
                            - type
                            - id
                            - name
                          additionalProperties: false
                        role:
                          type: string
                          enum:
                            - ADMIN
                            - MEMBER
                            - VIEWER
                            - CUSTOM
                        customRoleId:
                          type:
                            - string
                            - 'null'
                        customRoleName:
                          type:
                            - string
                            - 'null'
                        scopeType:
                          type: string
                          enum:
                            - PROJECT
                            - TEAM
                            - ORGANIZATION
                        scopeId:
                          type: string
                        scopeName:
                          type:
                            - string
                            - 'null'
                        createdAt:
                          type: string
                          format: date-time
                        expiresAt:
                          anyOf:
                            - type: string
                              format: date-time
                            - type: 'null'
                      required:
                        - id
                        - principal
                        - role
                        - customRoleId
                        - customRoleName
                        - scopeType
                        - scopeId
                        - scopeName
                        - createdAt
                        - expiresAt
                      additionalProperties: false
                  totalCount:
                    type: number
                required:
                  - bindings
                  - totalCount
                additionalProperties: false
      deprecated: true
      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.