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_teams

List every team the authenticated user owns or belongs to. Read-only — team CRUD stays in the dashboard.

Purpose

List every team the caller has visibility into. Useful before minting a token scoped to a specific team — agents can surface a picker instead of making the user hunt for a UUID. Read-only; team create/update/delete flows stay in the dashboard.

Required ability

team:view-any

Input schema

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

Output shape

{
  "data": [
    {
      "id": "tem_01HX...",
      "name": "Research Collective",
      "owner_user_id": "usr_01HX...",
      "personal": true,
      "created_at": "2026-01-12T10:05:00Z"
    }
  ],
  "meta": { "total": 1 }
}

personal is true for the auto-created signup team and false for every other team the user created or joined.

Example prompts

"Which teams do I belong to?"

"List my teams so I know where to scope my next API token."

Failure modes

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

How is this guide?

get_team

Fetch a single team by UUID from the caller's visibility set (owned + membership). Foreign teams return RESOURCE_NOT_FOUND.

list_team_members

List collaborators on a team. Owner pseudo-row is prepended; role_id is null for the owner.