List all access groups

Returns a paginated list of all access groups on the site, including both custom (user-created) and scope (Notion-collection-based) groups.

Each group in the response includes: id, name, description, type ('custom' or 'scope'), memberCount (number of members in the group), and timestamps.

Custom groups can be modified via the API. Scope groups are automatically created from Notion collections and are read-only — they cannot be created, updated, or deleted via the API.

GET /api/v1/access-groups

Bearer token

curl 'https://api.sotion.so/api/v1/access-groups?limit=50&after=123e4567-e89b-42d3-a456-426614174000' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "123e4567-e89b-42d3-a456-426614174000",
      "name": "example",
      "description": "example",
      "type": "custom",
      "memberCount": 1,
      "createdAt": "2026-01-01T12:00:00Z",
      "updatedAt": "2026-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "123e4567-e89b-42d3-a456-426614174000"
  }
}

Paginated list of access groups.

Query parameters

· 2

limit integer · min: 1· max: 100· default: 50

Number of items to return per page (1-100). Default: 50.

after string · uuid

Cursor for pagination. Pass the nextCursor value from a previous response to get the next page of results.

Query parameters

Responses