List grants

List all grants for a given object.

Usage notes

You can specify one of the following:

  • A user by userId. Retrieve the userId by calling the /v2/members endpoint and using the memberId included in the response.
  • A team by teamId. Retrieve the teamId by calling the /v2/teams endpoint.
  • A document (such as a workbook, data model, or dataset), folder, or workspace by inodeId. Retrieve the inodeId by calling the /v2/files endpoint and using the id included in the response.

Usage scenarios

  • Manage inherited permissions: Identify files and folders that have permissions directly granted to them.
  • Review long-lived permissions: Audit permissions granted more than a year ago and determine if they are still needed.
Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Use to specify further pages using the string returned in the nextPage portion of the response.

number

Number of results to return per page, with a maximum of 1,000 per request. Use the page option in subsequent requests to retrieve the next set of results.

string
string
string
boolean
Responses

Language
Credentials
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json