Early bird discounts live! Claim your offer
MemberPass Logo

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": "tem_01HX...",
    "name": "Research Studio",
    "owner_user_id": "usr_01HX...",
    "personal": false,
    "created_at": "2026-05-18T10:05:00Z"
  }
}

Example prompts

"Show me team tem_01HX...."

"Which user owns this team?"

Failure modes

  • RESOURCE_NOT_FOUNDteam_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?

On this page

MemberPass is a product designed by you — for you.

No boardroom full of executives deciding what we ships next. Our roadmap always shaped by you with your feedback.

Share feedback or a request