Delete a custom access group

Permanently deletes a custom access group. All member-group relationships are cascade-deleted, but the members themselves are not deleted — they just lose membership in this group.

Scope-managed groups cannot be deleted via the API — attempting to delete one returns 403 Forbidden.

DELETE /api/v1/access-groups/{groupId}

Bearer token

curl 'https://api.sotion.so/api/v1/access-groups/123e4567-e89b-42d3-a456-426614174000' \
  --request DELETE \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

This response has no body.

Access group deleted.

Path parameters

· 1

groupId string · uuid required

UUID of the access group. Get group IDs from listAccessGroups or createAccessGroup responses.

Path parameters

Responses