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

# Update team configurations

> MCP tool to update configurations for a team in the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `update_team_configurations`

Updates configuration settings for a specific team, including timezone settings, business hours, routing preferences, and holidays. This tool allows you to modify how a team operates and how tickets are routed.

<Admonition type="note">
  You must provide the team ID and at least one configuration parameter to update.
</Admonition>

### Example prompt

```prompt theme={null}
Update team configurations for team T88WCYYHPS with timezone "America/New_York" and enable routing that respects timezone
```

<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>update\_team\_configurations</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name                            | Type      | Required | Description                                          |
| ------------------------------- | --------- | -------- | ---------------------------------------------------- |
| teamId                          | string    | Yes      | The ID of the team to update configurations for      |
| timezone                        | string    | No       | Team timezone (e.g., "America/New\_York")            |
| routingRespectsTimezone         | boolean   | No       | Whether routing rules respect the timezone           |
| routingRespectsUserCapacity     | boolean   | No       | Whether routing rules respect user capacity          |
| fallbackSubTeam                 | string    | No       | The fallback sub-team ID                             |
| holidays                        | string\[] | No       | Array of holiday dates (format: DD-MM or DD-MM-YYYY) |
| routingRespectsUserTimezone     | boolean   | No       | Whether routing rules respect user timezone          |
| routingRespectsUserAvailability | boolean   | No       | Whether routing rules respect user availability      |
| userRoutingStrategy             | string    | No       | User routing strategy ("manual" or "round\_robin")   |
| commonDailyConfig               | boolean   | No       | Whether to use common daily config                   |
| commonSlots                     | array     | No       | Common time slots for all days                       |
| dailyConfig                     | object    | No       | Day-specific configurations                          |

#### Time slot structure

Each time slot in `commonSlots` or `dailyConfig` contains:

| Field | Type   | Description                |
| ----- | ------ | -------------------------- |
| start | string | Start time in format HH:MM |
| end   | string | End time in format HH:MM   |

#### Daily config structure

The `dailyConfig` object contains day-specific configurations:

| Field    | Type    | Description                      |
| -------- | ------- | -------------------------------- |
| isActive | boolean | Whether this day is active       |
| slots    | array   | Array of time slots for this day |

### Response fields

The response will contain the updated team configuration with the same structure as the `get_team_configurations` tool.

### Sample response

```json theme={null}
{
  "data": {
    "timezone": "America/New_York",
    "teamId": "T88WCYYHPS",
    "fallbackSubTeam": "T99WCYYHPS",
    "holidays": ["25-12", "01-01"],
    "routingRespectsTimezone": true,
    "routingRespectsUserTimezone": true,
    "routingRespectsUserAvailability": true,
    "routingRespectsUserBusinessHours": true,
    "userRoutingStrategy": "ROUND_ROBIN",
    "commonDailyConfig": true,
    "dailyConfig": {
      "monday": {
        "isOpen": true,
        "startTime": "09:00",
        "endTime": "17:00"
      },
      "tuesday": {
        "isOpen": true,
        "startTime": "09:00",
        "endTime": "17:00"
      },
      "wednesday": {
        "isOpen": true,
        "startTime": "09:00",
        "endTime": "17:00"
      },
      "thursday": {
        "isOpen": true,
        "startTime": "09:00",
        "endTime": "17:00"
      },
      "friday": {
        "isOpen": true,
        "startTime": "09:00",
        "endTime": "17:00"
      },
      "saturday": {
        "isOpen": false,
        "startTime": null,
        "endTime": null
      },
      "sunday": {
        "isOpen": false,
        "startTime": null,
        "endTime": null
      }
    },
    "createdAt": "2025-07-24T07:19:10.258Z",
    "updatedAt": "2025-07-25T12:50:38.937Z"
  },
  "status": true,
  "message": "Team configurations updated 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>

<Admonition type="warning">
  This tool modifies team settings that affect ticket routing. Changes may impact how tickets are automatically assigned.
</Admonition>

***