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_FOUND—team_idis 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 lacksteam:view.
Related
How is this guide?