---
title: "Idempotently updates an existing team."
method: PATCH
path: "/teams/{identifier}"
tags: ["teams"]
---

# Idempotently updates an existing team.

`PATCH /teams/{identifier}`

Requires the privilege [`TEAMS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required

## Query parameters

- `teamId` string, required

## Request body

- UpdateTeamRequest — A request to update an team
  - `name` string — The name for the team
  - `production` boolean — Flag to determine if team is marked for production
  - `defaultTeamRole` string — The default team role
  - `prefs` TeamPrefsPatch — Prefs on team level
    - `testRunRestrictionWindows` TestRunRestrictionWindow[]
      - `dayOfWeek` 'M' | 'T' | 'W' | 'Th' | 'F' | 'S' | 'Su', required
      - `windowsForDay` ScheduleWindow[], required
        - `start` string, required — Time in HH:mm format (24-hour)
        - `end` string, required — Time in HH:mm format (24-hour)

## Response `default`

default response

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: TEAMS_WRITE

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)