---
title: "Patch Team"
method: PATCH
path: "/v1/accounts/{account_id}/teams/{team_id}"
tags: ["Teams"]
---

# Patch Team

`PATCH /v1/accounts/{account_id}/teams/{team_id}`

**Authorization scope:** `team:write` 
 
 **Patch team by id**

## Path parameters

- `team_id` string, required
- `account_id` string, required

## Request body

- PatchUserTeamsInput — Request patch user groups input.
  - `display_name` string, nullable — The display name
  - `description` string, nullable — Internal description
  - `environments` object, nullable — Dictionary of environment id and environment role
  - `default_environment` string, nullable — Default Environment ID for this team (Optional)
  - `is_all_environment_admin` boolean, nullable — Indicates if group have Admin permission for all environment

## Response `200`

Successful Response

- UserTeamsModel — Base user team model properties to return.
  - `_id` string, required — The user group id
  - `account_id` string, required — The account id
  - `display_name` string, required — The display name
  - `remote_display_name` string, nullable — The SCIM display name
  - `description` string, nullable — Internal description
  - `environments` object — Dictionary of environment id and environment role
  - `default_environment` string, nullable — Default Environment ID for this team (Optional)
  - `is_all_environment_admin` boolean — Indicates if group have Admin permission for all environment
  - `source` 'rivery' | 'active_directory' — The source group. can be locally from Rivery or imported from external provider
  - `created_at` string, date-time, required — Created team datatime

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/rivery/apis/boomi-data-integration-api.md) · [All operations](https://skmtc.net/rivery/apis/boomi-data-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivery/boomi-data-integration-api/revisions/cc19ddc41c6e/schema)