Skip to content
/
List grants
Last updated

List access grants

Retrieve a paginated list of access grants for an organization, with optional filters.

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/access/grants

Returns access grants matching the specified filters. You can filter by entity type, entity ID, grantee type, and grantee ID. Results are paginated.

Path Parameters

organization_id string required

The unique identifier of the organization (format: org_*).

Query Parameters

entity_type string optional

Filter by entity type. Allowed values: knowledge_slice, vector_store, assistant.

entity_id string optional

Filter by entity ID.

grantee_type string optional

Filter by grantee type. Allowed values: user, department, role.

grantee_id string optional

Filter by grantee ID.

skip integer optional · Defaults to 0

Number of items to skip for pagination.

limit integer optional · Defaults to 20

Maximum number of items to return (1-100).

Returns

A paginated list of access grant objects with items, total, skip, limit, and has_more fields.

cURL
curl -s -X GET "https://api.aitronos.com/v1/organizations/org_xyz789/access/grants?entity_type=knowledge_slice&limit=10" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Previous page
Next page