---
title: "Update team"
method: PATCH
path: "/organizations/{organization_id}/teams/{team_id}"
tags: ["Organization Teams"]
---

# Update team

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

Updates an existing team.

## Path parameters

- `organization_id` string, required
- `team_id` string, required

## Request body

- UpdateOrganizationTeamRequest
  - `description` string, nullable
  - `metadata` object, nullable
  - `name` string, required
  - `slug` string, nullable

## Response `200`

OK

- OrganizationTeam
  - `created_at` string, date-time, required
  - `description` string, nullable
  - `id` string, required
  - `metadata` object, nullable
  - `name` string, required
  - `organization_id` string, required
  - `slug` string, required
  - `updated_at` string, date-time, required

## Changes

- **2026-07-24** `3f0abf6aab3c` — 2 info
  - api tag `Organization Teams` added
  - api tag `Teams` removed
- **2026-07-09** `dad8e2644615` — 1 info
  - endpoint added
- **2026-07-08** `d2f9387037c5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/authula/apis/authula-api/changes/organizations/:organization_id/teams/:team_id/patch.md)

---

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