---
title: "Update a team"
url: https://docs.gleap.ai/en/reference/rest-api/put-teams-teamid
method: PUT
path: "/teams/{teamId}"
api: "API Reference"
tag: "Team"
operationId: "UpdateTeam"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Update a team

`PUT https://api.gleap.io/v3/teams/{teamId}`

Update a team.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Path parameters

- `teamId` (string, required)

## Headers

- `project` (string, required)

## Request body (`application/json`, required)

- `name` (string, required)
- `assignmentMethod` (enum<string>, required): One of: `random`, `balanced`, `manual`, `circular`.
- `members` (string[], required)
- `selectOnlyOnlineMembers` (boolean)
- `needQueueRerun` (boolean)
- `limitTicketAmount` (boolean)
- `ticketAmount` (number<double>)
- `countSnoozedTickets` (boolean)
- `slaOptions` (object)
  - `defaultSla` (number<double>)
- `operatingHours` (object)
  - `openingTimes` (object[])
    - `replyTime` (any)
    - `closingTime` (string)
    - `openingTime` (string)
    - `day` (string)
  - `staticTranslations` (object)
    - `outOfOfficeMessage` (any)
  - `replyTime` (any)
  - `alwaysOnline` (boolean)
  - `timezone` (string)
  - `enabled` (boolean)
- `lexorank` (string)
- `icon` (string | null): The team's icon: a Font Awesome solid icon name without the `fa-` prefix (`headset`, `user-group`) or one emoji. Empty string or null clears it. Checked by isValidTeamIcon (teamIcon.ts) in the controller.
- `agents` (object[]): Agents that take the team's new tickets first, in this order (teamBody.service checks them).
  - `agent` (string, required)
  - `boards` (string[] | null)
- `workingDays` (object): Working days of the team's people (teamBody.service keeps only members).
  - `mode` (enum<string>, required): One of: `everyone`, `by_day`.
  - `days` (object)
    - `sun` (string[])
    - `sat` (string[])
    - `fri` (string[])
    - `thu` (string[])
    - `wed` (string[])
    - `tue` (string[])
    - `mon` (string[])
- `taskDescription` (string | null): What the team handles, in a sentence: agents and Tasks route by it.
- `taskLead` (string | null): The team's lead: gets the team's unanswered asks. Must be a member.

## Example request

```bash
curl --request PUT \
  --url 'https://api.gleap.io/v3/teams/{teamId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<name>",
  "assignmentMethod": "random",
  "members": [
    "<members>"
  ]
}'
```

## Responses

### 200 (`application/json`)

Ok