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

# Update Team

`PATCH /v1/teams/{id}`

Updates the properties of an existing team, such as its name or type. With user permissions, the team must be one the requesting user has edit access to. With admin permissions, any team belonging to the account can be updated.

## Path parameters

- `id` number, required

## Headers

- `Lucid-Request-As` string

## Request body

- UpdateTeamBody
  - `name` string, required — The team's name. Max length of name is 80 characters.

## Response `200`

OK. Returns a Team resource containing information about the updated team.

- Team — A standard representation of a team.
  - `id` number — The unique ID for the team.
  - `name` string — The team's name.
  - `type` 'hidden' | 'closed' | 'open' — The type of the team
  - `created` string, date-time — Date and time when the team was created.
  - `archived` string, date-time, nullable — Date and time when the team was archived (if it has been archived).

## Other responses

- `400` — Bad Request. Occurs if the name in the request body is empty or exceeds the maximum allowed length.
- `403` — Forbidden. * if the user making the request does not have access to the specified team. * if the team is not directly accessible by the authenticated user or does not exist. * if the team is managed via SCIM. Use the SCIM Groups API to modify SCIM-managed teams.
- `409` — Conflict. Occurs if a team already exists with an identical name.

---

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