Roles

Get a role

One role with its permission codes. permissions is a flat array of the exact ability strings granted by this role, the same strings used as token abilities, so you can match roles against tokens without a second round-trip.

get/v1/roles/{role}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/roles/{role}
  • Auth: HTTP bearer

Path parameters

rolestring uuid required

The role, resolved by the route binder.

Response

The role resource with its permissions.

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.