---
title: "Update a specific team in a organization."
method: PATCH
path: "/orgs/{org}/teams/{team}/"
tags: ["orgs"]
---

# Update a specific team in a organization.

`PATCH /orgs/{org}/teams/{team}/`

Update a specific team in a organization.

## Request body

- OrganizationTeamRequestPatch
  - `description` string, nullable — A detailed description of the team.
  - `name` string — A descriptive name for the team.
  - `slug` string, slug
  - `visibility` 'Visible' | 'Hidden'

## Response `200`

Updated the specified team.

- OrganizationTeam
  - `description` string, nullable — A detailed description of the team.
  - `name` string, required — A descriptive name for the team.
  - `slug` string, slug
  - `slug_perm` string, slug
  - `visibility` 'Visible' | 'Hidden'

## Other responses

- `400` — The team cannot be edited.
- `404` — Team not found.
- `422` — Missing or invalid parameters (see detail).

---

[API](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1.md) · [All operations](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudsmith/cloudsmith-api-v1/revisions/4d7879df9b2f/schema)