---
search:
  tags:
    - teams
    - PATCH
seo:
  description: >-
    Updates only the provided fields of a team. All fields are optional.
    Reference for the PATCH /teams/{id} endpoint in the Leadtime Public API API.
sidebar:
  badge: PATCH
  label: Partially update a team
title: Partially update a team
type: openapi-operation
---
Updates only the provided fields of a team. All fields are optional.

**How partial updates work:**
- Only include the fields you want to change
- Omitted fields remain unchanged
- You can update the name, icon, members, or any combination

**Update scenarios:**
- Change team name: Provide only the "name" field
- Change icon: Provide only the "icon" field
- Update members: Provide only the "users" array with new user IDs
- Update multiple fields: Provide any combination of fields

**Important notes:**
- When updating members, provide the complete list of user IDs you want in the team
- The users array replaces the entire team membership (not merged)
- At least one user must remain in the team after update
- All user IDs must be valid UUIDs of existing employees

**What is returned:**
- Complete updated team details
- All current team members
- Updated metadata (name, icon, user count)

**Note:** Returns 404 if the team does not exist or has been deleted. This endpoint requires the Teams.edit permission.

<Operation source="api-reference" id="teamscontroller-patchteam" />