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!

get_team

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

Purpose

Fetch one team the authenticated user owns or belongs to. Foreign teams always return RESOURCE_NOT_FOUND to prevent existence leaks.

Required ability

team:view

Input schema

{
  "type": "object",
  "required": ["team_id"],
  "properties": {
    "team_id": {
      "type": "string",
      "description": "UUID of the team to fetch."
    }
  }
}

Output shape

{
  "data": {
    "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
    "name": "Research Studio",
    "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "personal": false,
    "created_at": "2026-05-18T10:05:00Z"
  }
}

Example prompts

"Show me team a83f0d51-4c92-4b7e-8615-2fd9e70a3c86."

"Which user owns this team?"

Failure modes

RESOURCE_NOT_FOUND — team_id is not a valid UUID, or it falls outside the caller's visibility set.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks team:view.

How is this guide?

create_team

Create a team owned by the caller. Growth-tier capability.

update_team

Rename a team. Owner only, Growth-tier capability.