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.

Example Prompt

Update team configurations for team T88WCYYHPS with timezone "America/New_York" and enable routing that respects timezone

Input Parameters

NameTypeRequiredDescription
teamIdstringYesThe ID of the team to update configurations for
timezonestringNoTeam timezone (e.g., “America/New_York”)
routingRespectsTimezonebooleanNoWhether routing rules respect the timezone
routingRespectsUserCapacitybooleanNoWhether routing rules respect user capacity
fallbackSubTeamstringNoThe fallback sub-team ID
holidaysstring[]NoArray of holiday dates (format: DD-MM or DD-MM-YYYY)
routingRespectsUserTimezonebooleanNoWhether routing rules respect user timezone
routingRespectsUserAvailabilitybooleanNoWhether routing rules respect user availability
userRoutingStrategystringNoUser routing strategy (“manual” or “round_robin”)
commonDailyConfigbooleanNoWhether to use common daily config
commonSlotsarrayNoCommon time slots for all days
dailyConfigobjectNoDay-specific configurations

Time Slot Structure

Each time slot in commonSlots or dailyConfig contains:
FieldTypeDescription
startstringStart time in format HH:MM
endstringEnd time in format HH:MM

Daily Config Structure

The dailyConfig object contains day-specific configurations:
FieldTypeDescription
isActivebooleanWhether this day is active
slotsarrayArray 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

{
  "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"
}