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.