Early bird discounts live! Claim your offerMemberPass is now live! To celebrate we have introduced amazing early bird discounts for a limited time! Claim your offer now!

list_groups

List groups across every team the caller owns or belongs to. Lighter-weight than roles — no permission payload.

Purpose

List groups across every team the caller owns or belongs to. Groups cluster users without a permission payload — lighter-weight than roles. Ordered newest-first.

Required ability

group:view-any

Input schema

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

Output shape

{
  "data": [
    {
      "id": "grp_01HX...",
      "team_id": "tem_01HX...",
      "code": "ops",
      "name": "Ops",
      "created_at": "2026-05-18T10:05:00Z"
    }
  ],
  "meta": { "total": 1 }
}

Example prompts

"List all groups across my teams."

"Which groups exist on my Research Studio team?"

Failure modes

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

How is this guide?

list_roles

List roles across every team the caller owns or belongs to. Each role carries a flat permission list.

list_tokens

List the authenticated user's own personal access tokens with abilities and scope tuples split out.