---
title: "Update Team"
method: PATCH
path: "/team-messaging/v1/teams/{chatId}"
tags: ["Teams"]
---

# Update Team

`PATCH /team-messaging/v1/teams/{chatId}`

Updates the name and description of the specified team.

## Path parameters

- `chatId` string, required

## Request body

- TMUpdateTeamRequest
  - `public` boolean — Team access level
  - `name` string — Team name. Maximum number of characters supported is 250
  - `description` string — Team description. Maximum number of characters supported is 1000

## Response `200`

Success

- TMTeamInfo
  - `id` string — Internal identifier of a team
  - `type` 'Team' — Type of chat
  - `public` boolean — Team access level
  - `name` string — Team name
  - `description` string — Team description
  - `status` 'Active' | 'Archived' — Team status
  - `creationTime` string, date-time — Team creation datetime in ISO 8601 format
  - `lastModifiedTime` string, date-time — Team last change datetime in ISO 8601 format

## Other responses

- `400` — One of body parameters has invalid value.
- `403` — User is not Team Admin or Team is not active.
- `404` — Team Not Found.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)