---
title: "UpdateTeam"
method: PATCH
path: "/api/admin/teams/{team_id}"
tags: ["Admin"]
---

# UpdateTeam

`PATCH /api/admin/teams/{team_id}`

## Path parameters

- `team_id` string, uuid, required

## Request body

- AdminTeamUpdate
  - `description` string, nullable
  - `is_active` boolean
  - `name` string, nullable

## Response `200`

Request fulfilled, document follows

- AdminTeamDetail
  - `createdAt` string, date-time, required
  - `description` string, nullable
  - `id` string, uuid, required
  - `isActive` boolean
  - `memberCount` integer
  - `members` AdminTeamMember[]
    - `isOwner` boolean, required
    - `role` string, required
    - `user` User, required
      - `avatarUrl` string, nullable
      - `email` string, required
      - `hasPassword` boolean
      - `id` string, uuid, required
      - `isActive` boolean
      - `isSuperuser` boolean
      - `isTwoFactorEnabled` boolean
      - `isVerified` boolean
      - `name` string, nullable
      - `oauthAccounts` OauthAccount[]
        - `accountEmail` string, required
        - `accountId` string, required
        - `id` string, uuid, required
        - `oauthName` string, required
      - `phone` string, nullable
      - `roles` UserRole[]
        - `assignedAt` string, date-time, required
        - `roleId` string, uuid, required
        - `roleName` string, required
        - `roleSlug` string, required
      - `teams` UserTeam[]
        - `isOwner` boolean
        - `role` 'ADMIN' | 'MEMBER' — Valid Values for Team Roles.
        - `teamId` string, uuid, required
        - `teamName` string, required
      - `username` string, nullable
  - `name` string, required
  - `ownerEmail` string, nullable
  - `slug` string, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad request syntax or unsupported method

## Changes

> 3 revisions in range; 1 could not be searched.

- **2026-01-08** `1fd74fd1e951` — 1 warning
  - removed the optional property `members` from the response with the `200` status

[Change history](https://skmtc.dev/litestar-org/apis/litestar-fullstack-template/changes/api/admin/teams/:team_id/patch.md)

---

[API](https://skmtc.dev/litestar-org/apis/litestar-fullstack-template.md) · [All operations](https://skmtc.dev/litestar-org/apis/litestar-fullstack-template/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/litestar-org/litestar-fullstack-template/revisions/e5e7606282ec/schema)