Skip to content
Last updated

Get all users who have access to a specific entity, along with their effective access levels.

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/access/users-with-access

Returns all users who have access to the specified entity, including their effective access level and the grant paths that explain how access was derived (direct grants, department membership, role assignment, or composite slice membership).

Alternate path: This endpoint is also available at GET /v1/organizations/{organization_id}/knowledge/users-with-access with the same parameters and response.

Path Parameters

organization_id string required

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

Query Parameters

entity_type string required

The type of entity. Allowed values: knowledge_slice, vector_store, assistant.

entity_id string required

The unique identifier of the entity.


Returns

A response containing entity_type, entity_id, and a users array. Each user entry includes user_id, access_level (the highest effective level), and grant_paths explaining how access was derived.

cURL
curl -s -X GET "https://api.aitronos.com/v1/organizations/org_xyz789/access/users-with-access?entity_type=knowledge_slice&entity_id=kslice_abc123" \
  -H "Authorization: Bearer $ACCESS_TOKEN"