---
title: "Update Team"
method: PATCH
path: "/v0/organizations/{organization_id}/teams/{team_id}"
tags: ["Teams & Resource Access"]
---

# Update Team

`PATCH /v0/organizations/{organization_id}/teams/{team_id}`

Update a team.

Requires org:write permission (Owner and Admin roles have this).

:param request_fastapi: FastAPI request object.
:param organization_id: Organization ID.
:param team_id: Team ID.
:param team_data: Team update data.
:param session: Database session.
:return: Updated team.

## Path parameters

- `organization_id` integer, required
- `team_id` integer, required

## Request body

- TeamUpdate — Schema for updating a team.
  - `name` string, nullable
  - `description` string, nullable

## Response `200`

Successful Response

- TeamResponse — Schema for team response.
  - `id` integer, required
  - `name` string, required
  - `description` string, nullable, required
  - `organization_id` integer, required
  - `created_at` string, date-time, required
  - `member_count` integer, nullable
  - `members` string[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.dev/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)