Skip to main content
DELETE
Delete a group
The organization bot token must have the following scopes:
  • permission-group:write
If deleting the group would orphan access, pass an active workspace owner as transfer_to_owner_id. Omitting a required transfer target returns a 409 conflict_error and leaves the group unchanged. SCIM-managed groups must be deleted 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

Query Parameters

transfer_to_owner_id
string

Active workspace owner who receives access that would otherwise be orphaned.

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.