List grants for a workspace

This endpoint retrieves a list of all permission grants associated with a specific workspace, identified by its workspaceId.

Usage notes

  • Retrieve the workspaceId by calling the /v2/workspaces endpoint.
  • Optionally use the page and limit parameters to manage the size of the returned data and navigate through large datasets.

Usage scenarios

  • Access control management: Useful for administrators to review and manage who has what access to the workspace.
  • Audit and compliance: Assists in compliance checks and audits by providing a clear view of the permissions granted to different users and teams.

Best practices

  • Use pagination: Especially important for workspaces with a large number of grants to ensure performance and usability.
  • Regular review: Regularly review and update the workspace grants to ensure they align with current organizational policies and user roles.
Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique identifier of the workspace.

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.

Responses

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