Skip to navigation
Workspace APIAuthorization

List resources the current user can access for a permission

View as Markdown

Discovers the resource external ids the authenticated caller holds a given permission on. Authorization: any authenticated organization member — scoped to the caller’s membership. Query: permission and resourceType (required); parentResourceType + parentResourceExternalId (optional) scope the search to the immediate children of that parent. Omit the parent fields to search from the organization root. Returns { permission, resourceType, externalIds }. With no membership claim, returns an empty externalIds.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

permissionstringRequired>=1 character
resourceTypestringRequired>=1 character
parentResourceTypestringOptional>=1 character
parentResourceExternalIdstringOptional>=1 character

Response

The external ids the caller may access under the permission.
permissionstring
resourceTypestring
externalIdslist of strings

External ids the caller holds permission on.