Early bird discounts live! Claim your offerSubscriby 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": "1f68d92a-04c5-4e83-97b1-3d6a05e2f847",
      "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
      "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?

delete_group

Delete a group. Members stay in the team but lose what it granted.

list_tokens

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