---
title: "Update Team"
method: PATCH
path: "/organizations/teams/{teamId}"
tags: ["Organization"]
---

# Update Team

`PATCH /organizations/teams/{teamId}`

Updates an existing team's information. You can modify the team's name and parent team assignment. This operation can be used to restructure the team hierarchy within the organization.

## Path parameters

- `teamId` string, required

## Request body

- UpdateTeamRequest
  - `name` string
  - `parentTeamUUID` string

## Response `200`

Team successfully updated

- UpdateTeamResponse
  - `data` Team — Represents a team in the system with its properties and hierarchical structure
    - `uuid` string — Unique identifier of the team
    - `name` string — Name of the team
    - `phrases` string[] — List of keywords or phrases associated with the team
    - `slackConnection` SlackConnection — Represents the Slack integration details for a team
      - `id` string — Slack connection identifier
      - `info` SlackTeamInfo — Information about a connected Slack team
        - `id` string — Slack team identifier
        - `name` string — Name of the Slack team
    - `domain` string — Domain associated with the team
    - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
    - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
    - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
    - `organizationUUID` string — UUID of the organization this team belongs to
    - `children` Team[] — List of child teams if this team has a hierarchical structure

## Other responses

- `400` — Failed to fetch team or invalid update parameters
- `401` — Valid API key required
- `409` — A team with the same name already exists in the organization
- `422` — Missing or invalid body parameters
- `500` — Unexpected server error. Please try again later.
- `default` — unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/versions/5de55d3804cf/schema)