Groups

List groups

curl https://api.subscriby.net/v1/groups \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Every group across the teams the caller sees, newest first. Rows carry neither permissions nor member_ids; read a group individually for those. Visibility is the union of every team the caller owns or belongs to; a group from a team the caller cannot see answers 404 RESOURCE_NOT_FOUND rather than 403, so the API cannot be used to discover that a group id exists.

get/v1/groups

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/groups
  • Auth: HTTP bearer

Query parameters

pageinteger

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

per_pageinteger

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 25.

sort_bystring

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

sort_direction'asc' | 'desc'

asc or desc. Defaults to desc.

Response

Groups across every team the caller belongs to.

Example response

{
  "data": [
    {
      "id": "1f68d92a-04c5-4e83-97b1-3d6a05e2f847",
      "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
      "code": "ops",
      "name": "Ops",
      "permissions": [
        "project:view-any"
      ],
      "member_ids": [
        "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80"
      ],
      "created_at": "2026-05-18T10:05:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.