Roles

List roles

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

Every role across the teams the caller can see, with its permission codes. Visibility is the union of every team the caller owns or belongs to; a role from a team the caller cannot see answers 404 RESOURCE_NOT_FOUND rather than 403, so existence never leaks.

get/v1/roles

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/roles
  • 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

Roles across every team the caller belongs to.

Example response

{
  "data": [
    {
      "id": "d05e1a83-7c46-4f29-b613-8ae407c9d251",
      "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
      "code": "manager",
      "name": "Manager",
      "description": "Manage plans, resources, and subscribers",
      "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
      "permissions": [
        "project:view"
      ],
      "created_at": "2026-05-18T10:05:00Z"
    }
  ]
}

Changes

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