Skip to main content
GET
Retrieve a group
The organization bot token must have the following scopes:
  • permission-group:read
Returns an admin-managed or SCIM-managed permission group by ID. SCIM-managed groups are readable, but must be changed through the configured identity provider.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

group_id
string
required

The ID of the group.

space_id
string<uuid>
required

Response

object
string
required

Always group

Allowed value: "group"
id
string
required

The ID of the group.

name
string
required

The name of the group.