SIsigmacomputing
Grants

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, report, data model, or dataset (deprecated)), folder, or workspace by inodeId.
    • Retrieve the inodeId by calling the /v2/files endpoint and using the id included in the response.
    • Retrieve the inodeId for a data model by calling the /v2/dataModels endpoint and using the dataModelId 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.
get/v2/grants

Request

  • Base URL
    https://api.sigmacomputing.com
  • Auth
    HTTP bearer

Query parameters

pagestring

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

limitnumber double

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.

inodeIdstring
teamIdstring
userIdstring
directGrantsOnlyboolean

Response

The response body.

nextPagestring nullable required

Returns a string that can be used as the page parameter in the next request to fetch the next page of results. The last page of results returns null.

totalnumber double

Total number of results. Useful to determine if there is a need to paginate.

hasMoreboolean

[Deprecated] Indicates whether more results are available.

Changes

No recorded changes to this operation across all 1 revision of this API.