---
title: "Update a team"
method: PATCH
path: "/v1/public/teams/{teamId}"
tags: ["Public", "Teams"]
---

# Update a team

`PATCH /v1/public/teams/{teamId}`

## Path parameters

- `teamId` string, required

## Request body

- UpdatePublicTeamRequest
  - `names` object — the name of the team in various locales. Accepted locales are en, fr, es
  - `division` string — If specified, the team will be linked to this division. The value can be either a division code or a division uid.
  - `locations` string[] — If specified, the team will be linked the locations. The value can be either location codes or location uids.
  - `skills` string[] — If specified, the team will be linked the skills (positions). The value can be either skill codes or skill uids.
  - `timeZone` string — If specified, the team time zone. The possible values can be seen here https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If not specified to company time zone will be used. The team time zone is used to preset the time zone of shifts created on the this team.
  - `code` string — A human readable ID that can be use has an ID for other API calls. The code is also used to map a team to an external system structural element.
  - `externalId` string — A unique UID or a human readable ID that can be use has an ID for other API calls. The externalId can also be used to map a team to an external system structural element.
  - `custom` object — To set custom fields to a team. You can pass a json objet where the values are string. Will merge with previous values.

## Response `200`

- PublicTeam
  - `uid` string, required — unique team id
  - `status` 'active' | 'deleted', required — Team status
  - `names` object, required — Multilingual team name as a map indexed by locale ("en" or "fr")
  - `code` string — The team code. The code is often used as a mapping value between Evolia and an external system
  - `externalId` string — The unique team externalId. The externalId is often used as a mapping value between Evolia and an external system
  - `locationIds` string[], required — Array of location UIDs linked to the team
  - `skillIds` string[], required — Array of skill UIDs linked to the team
  - `custom` object, nullable — An optional object of custom properties. Current implementation only support string values

---

[API](https://skmtc.dev/evolia/apis/public-evolia.md) · [All operations](https://skmtc.dev/evolia/apis/public-evolia/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolia/public-evolia/revisions/91b80f2b4802/schema)