Get subteams - Thena AI

MCP tool: `get_subteams`

Retrieves all subteams for a specific parent team. This tool is useful for understanding team hierarchy and organizational structure within the Thena platform.

Example prompt

Get subteams for team T88WCYYHPS

Input parameters

Name	Type	Required	Description
teamId	string	Yes	The ID of the parent team to retrieve subteams for

Response fields

Below are the fields you may see in each subteam object in the response:

Field	Type	Description
id	string	Subteam unique ID
name	string	Subteam name
icon	string	Subteam icon
color	string	Subteam color
parentTeamId	string	ID of the parent team
parentTeamName	string	Name of the parent team
teamId	string	Subteam ID (same as id)
identifier	string	Subteam identifier/code
description	string	Subteam description
teamOwner	string	Name of the subteam owner
teamOwnerId	string	ID of the subteam owner
fallbackSubTeam	string	Fallback sub team ID
createdAt	string (ISO8601)	Creation timestamp
isActive	boolean	Whether the subteam is active
isPrivate	boolean	Whether the subteam is private
archivedAt	string (ISO8601)	Archived timestamp (if archived)
updatedAt	string (ISO8601)	Last update timestamp

Sample response

{
  "data": [
    {
      "id": "T99WCYYHPS",
      "name": "Frontend Team",
      "icon": "🎨",
      "color": "#8B5CF6",
      "parentTeamId": "T88WCYYHPS",
      "parentTeamName": "Engineering",
      "teamId": "T99WCYYHPS",
      "identifier": "FE",
      "description": "Frontend development subteam",
      "teamOwner": "Alice Johnson",
      "teamOwnerId": "USER789",
      "fallbackSubTeam": null,
      "createdAt": "2025-07-24T09:19:10.258Z",
      "isActive": true,
      "isPrivate": false,
      "archivedAt": null,
      "updatedAt": "2025-07-24T09:19:10.258Z"
    },
    {
      "id": "TAAWCYYHPS",
      "name": "Backend Team",
      "icon": "⚙️",
      "color": "#F59E0B",
      "parentTeamId": "T88WCYYHPS",
      "parentTeamName": "Engineering",
      "teamId": "TAAWCYYHPS",
      "identifier": "BE",
      "description": "Backend development subteam",
      "teamOwner": "Bob Wilson",
      "teamOwnerId": "USER101",
      "fallbackSubTeam": null,
      "createdAt": "2025-07-24T10:19:10.258Z",
      "isActive": true,
      "isPrivate": false,
      "archivedAt": null,
      "updatedAt": "2025-07-24T10:19:10.258Z"
    }
  ],
  "status": true,
  "message": "Subteams retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}