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

GET /api/v1/role-bindings

Python

Python

import requests

url = "https://app.langwatch.ai/api/v1/role-bindings"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "bindings": [
    {
      "id": "<string>",
      "principal": {
        "type": "user",
        "id": "<string>",
        "name": "<string>"
      },
      "role": "ADMIN",
      "customRoleId": "<string>",
      "customRoleName": "<string>",
      "scopeType": "PROJECT",
      "scopeId": "<string>",
      "scopeName": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "expiresAt": "2023-11-07T05:31:56Z"
    }
  ],
  "totalCount": 123
}

Authorizations

Authorization · string · header · required

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

Query Parameters

userId · string

Minimum string length: 1

groupId · string

Minimum string length: 1

apiKeyId · string

Minimum string length: 1

scopeType · enum<string>

Available options: PROJECT, TEAM, ORGANIZATION

scopeId · string

Minimum string length: 1

offset · integer

Required range: 0 <= x <= 9007199254740991

limit · integer

Required range: 1 <= x <= 200

Response

200 - application/json

Success

bindings · object[] · required

Show child attributes

totalCount · number · required