> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get subteams

> MCP tool to retrieve all subteams for a parent team in the Thena platform.

import Admonition from '@theme/Admonition';

### 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.

<Admonition type="note">
  You must provide the parent team ID to retrieve its subteams.
</Admonition>

### Example prompt

```prompt theme={null}
Get subteams for team T88WCYYHPS
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>get\_subteams</code> tool with the correct arguments.
</Admonition>

### 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:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

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

### Sample response

```json theme={null}
{
  "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"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

***