---
title: "Update a team"
method: PUT
path: "/user-service/teams/{teamId}"
tags: ["Teams"]
---

# Update a team

`PUT /user-service/teams/{teamId}`

Update an existing team

## Request body

- TeamUpdateRequest
  - `name` string — Team name
  - `description` string, nullable — Team description
  - `user_ids` string[] — List of user IDs that belong to this team
  - `attached_role_ids` string[] — List of role IDs assigned to this team

## Response `200`

Updated team

- TeamResponse
  - `id` string, uuid, required — Unique identifier for the team
  - `account_id` string, required — Account identifier this team belongs to
  - `name` string, required — Team name
  - `description` string, nullable — Team description
  - `users` object[] — List of users with their IDs and names
    - `id` string, uuid — User ID
    - `name` string — User name
  - `attached_role_ids` string[] — List of role IDs assigned to this team
  - `created_at` string, date-time, required — When the team was created
  - `updated_at` string, date-time, required — When the team was last updated

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Team not found

---

[API](https://skmtc.net/firefly/apis/firefly-user-management-service-api.md) · [All operations](https://skmtc.net/firefly/apis/firefly-user-management-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/firefly-user-management-service-api/revisions/3d5d69795558/schema)