List groups
Permission groups
List groups
List permission groups in a workspace.
GET
List groups
The organization bot token must have the following scopes:
permission-group:read
id to retrieve the group or manage its direct user memberships.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The Admin API version to use for this request.
Available options:
2026-06-01 Path Parameters
Query Parameters
Number of groups to return (1–100; default 100).
Required range:
1 <= x <= 100Opaque continuation cursor from a previous page.
Response
Always list
Allowed value:
"list"Always group
Allowed value:
"group"The permission groups in the workspace.
Maximum array length:
100Whether another page is available.
Cursor for the next page, or null on the last page.