list_roles

Purpose

List roles across every team the caller owns or belongs to. Each role carries a flat permissions array — the same ability codes a token would use. Ordered newest-first.

Required ability

role:view-any

Input schema

{
  "type": "object",
  "properties": {}
}

Output shape

{
  "data": [
    {
      "id": "rol_01HX...",
      "team_id": "tem_01HX...",
      "code": "manager",
      "name": "Manager",
      "description": "Manage plans, resources, and subscribers",
      "permissions": ["project:view", "project:update", "project-user:update"],
      "created_at": "2026-05-18T10:05:00Z"
    }
  ],
  "meta": { "total": 3 }
}

Example prompts

"Which roles exist across my teams and what can each of them do?"

"Show me the permission list of the Manager role."

Failure modes

• AUTHENTICATION_REQUIRED — no authenticated user on the request.
• TOKEN_MISSING_ABILITY — token lacks role:view-any.

Related

• list_groups
• list_team_members
• Roles API