Sotion

Access Groups

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 /access-groups/{groupId}

Delete a custom access group

curl --request DELETE \
  --url 'https://api.sotion.so/api/v1/access-groups/{GROUPID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

No Body

Access group deleted.

Authorizations

  • Authorization string required header

    Per-site API key (prefix: so_...). Each key is scoped to exactly one Sotion site — the site context is determined entirely by the key. No site ID is needed in any URL. Pass as: Authorization: Bearer so_...

Path Parameters

  • groupId string (uuid) required

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

Response

  • X-RateLimit-Limit integer response header

    Maximum requests allowed in the current window.

  • X-RateLimit-Remaining integer response header

    Requests remaining in the current window.

  • X-RateLimit-Reset integer response header

    Unix timestamp (seconds) when the rate limit window resets.

  • X-Request-Id string (uuid) response header

    Unique request identifier for support and debugging.