GuidesAPI Reference
API Reference

List grants on users, apps, or groups

get
https://Use API Lookup for a base URL/grants/resources//entities

List grants on user, apps, or groups. This call describes the permissions assigned to any user, app, or group in the same realm as the calling principal unless includeCrossRealmGrants is true that has been granted access to the specified resource through an exact matching permission. Permissions granted through policies and roles are not included.


Access Control:

  • The calling principal must have either "listGrants" or "share" action permission for the resource "{resourceHrn}" in the "authorization" service.
  • The realm of the calling principal MUST match the realm of the requested app.
  • The calling principal MUST NOT include a project scope.
Path Params
string
required

The hrn that identifies the resource

Query Params
string

Restrict to only this type of entity in the response. Must be one of user, app, or group

boolean

List grants on user, app, or group that have been shared across all realms. Only entityId and permissions will be included in the response. The default value is false.

string

When there are more than 'count' total records, use the pageToken from the previous page to retrieve the next page

integer

Number of records to return.

Responses

Updated 2 months ago

Language
Credentials
Bearer
JWT
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 2 months ago