v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1425156138.7 KB

Lists the users and groups who have the Grafana <code>Admin</code> and <code>Editor</code> roles in this workspace. If you use this operation without specifying <code>userId</code> or <code>groupId</code>, the operation returns the roles of all users and groups. If you specify a <code>userId</code> or a <code>groupId</code>, only the roles for that user or group are returned. If you do this, you can specify only one <code>userId</code> or one <code>groupId</code>.

get/workspaces/{workspaceId}/permissions

Path parameters

workspaceIdstring required

The ID of the workspace to list permissions for. This parameter is required.

Query parameters

maxResultsinteger

The maximum number of results to include in the response.

nextTokenstring

The token to use when requesting the next set of results. You received this token from a previous <code>ListPermissions</code> operation.

userType'SSO_USER' | 'SSO_GROUP'

(Optional) If you specify <code>SSO_USER</code>, then only the permissions of IAM Identity Center users are returned. If you specify <code>SSO_GROUP</code>, only the permissions of IAM Identity Center groups are returned.

userIdstring

(Optional) Limits the results to only the user that matches this ID.

groupIdstring

(Optional) Limits the results to only the group that matches this ID.

Response

Success

nextTokenstring

The token to use in a subsequent <code>ListPermissions</code> operation to return the next set of results.