List access bindings
curl --request GET \
--url https://{host}/v2/workspaces/slug:storage/webhooks/v1/knowledge_bases/{knowledgeBaseId}/access \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/v2/workspaces/slug:storage/webhooks/v1/knowledge_bases/{knowledgeBaseId}/access', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/v2/workspaces/slug:storage/webhooks/v1/knowledge_bases/{knowledgeBaseId}/access"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"object": "knowledge_base.access_binding",
"knowledge_base_id": "<string>",
"principal_type": "user",
"principal_id": "<string>",
"role": "owner",
"created_at": 123,
"email": "<string>",
"org_slug": "<string>",
"granted_by": "<string>",
"updated_at": 123
}
],
"total": 1,
"page": 2,
"limit": 50,
"has_more": true
}Access
List access bindings
Requires admin+ (or owner).
GET
/
v1
/
knowledge_bases
/
{knowledgeBaseId}
/
access
List access bindings
curl --request GET \
--url https://{host}/v2/workspaces/slug:storage/webhooks/v1/knowledge_bases/{knowledgeBaseId}/access \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/v2/workspaces/slug:storage/webhooks/v1/knowledge_bases/{knowledgeBaseId}/access', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/v2/workspaces/slug:storage/webhooks/v1/knowledge_bases/{knowledgeBaseId}/access"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"object": "knowledge_base.access_binding",
"knowledge_base_id": "<string>",
"principal_type": "user",
"principal_id": "<string>",
"role": "owner",
"created_at": 123,
"email": "<string>",
"org_slug": "<string>",
"granted_by": "<string>",
"updated_at": 123
}
],
"total": 1,
"page": 2,
"limit": 50,
"has_more": true
}Authorizations
User session JWT or instance API key (iak_*). Send as Authorization: Bearer <token>.
Path Parameters
Knowledge base id. Legacy physical prefix vs_ (the kb_ rename is deferred).
Maximum string length:
128Pattern:
^vs_[A-Za-z0-9-]+$Query Parameters
Page size. Server clamps to [1, 100] silently.
Required range:
1 <= x <= 1001-based page number.
Required range:
x >= 1Response
Paginated bindings.
Shared list-response envelope. Array is always data. Every
element carries its own object discriminator.
Available options:
list Hide child attributes
Hide child attributes
Available options:
knowledge_base.access_binding Pattern:
^vs_[A-Za-z0-9-]+$Available options:
user, group, org, agent Maximum string length:
128Available options:
owner, admin, editor, reader Resolved at read time for user principals.
Required range:
x >= 0Required range:
x >= 1Required range:
1 <= x <= 100Was this page helpful?