Skip to main content

​
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

NameTypeRequiredDescription
teamIdstringYesThe 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:
FieldTypeDescription
idstringSubteam unique ID
namestringSubteam name
iconstringSubteam icon
colorstringSubteam color
parentTeamIdstringID of the parent team
parentTeamNamestringName of the parent team
teamIdstringSubteam ID (same as id)
identifierstringSubteam identifier/code
descriptionstringSubteam description
teamOwnerstringName of the subteam owner
teamOwnerIdstringID of the subteam owner
fallbackSubTeamstringFallback sub team ID
createdAtstring (ISO8601)Creation timestamp
isActivebooleanWhether the subteam is active
isPrivatebooleanWhether the subteam is private
archivedAtstring (ISO8601)Archived timestamp (if archived)
updatedAtstring (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"
}