Skip to main content
PATCH
Update a group member
The organization bot token must have the following scopes:
  • permission-group:write
Set role to owner or member. Restricted members cannot be group owners. SCIM-managed memberships must be changed through the configured identity provider. Trying to update one returns a 409 conflict_error.

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.

user_id
string
required

The ID of the user.

space_id
string<uuid>
required

Body

application/json
role
enum<string>
required

The user's new role in the group.

Available options:
owner,
member

Response

object
string
required

Always group_membership

Allowed value: "group_membership"
group_id
string
required

The ID of the group.

member
object
required

The direct user member.

role
enum<string>
required

The user's role in the group.

Available options:
owner,
member