---
title: "Update a Team"
method: PATCH
path: "/1/accounts/{account}/teams/{team}"
tags: ["User Management > Teams"]
---

# Update a Team

`PATCH /1/accounts/{account}/teams/{team}`

Update a Team for a given Account.

## Path parameters

- `account` integer, required
- `team` integer, required

## Request body

- object
  - `color_id` integer — Unique identifier of the `color` of the resource `{name}`
  - `description` string, nullable — Description of the resource `{name}`
  - `logo` 'archive-box' | 'chart-bars-outline' | 'cloud' | 'database-outline' | 'envelope' | 'flash-1' | 'ia-magic-wand' | 'id-card' | 'layout-4-squares-outline' | 'light-bulb-shine-2' | 'lock-outline' | 'multi-bubble-speach' | 'multiple-users' | 'network-thin' | 'pie-chart-outline' | 'shield-neutral' | 'synchronize' | 'time-clock-circle-alternate' | 'window-cog-light', nullable — Logo for the team
  - `name` string — Name of the resource Team
  - `owned_by_id` integer — Unique identifier of the user that owned the resource Team
  - `owned_by_ids` integer[], nullable — Array of user IDs who are owners of the team
  - `parent_id` integer, nullable — Unique identifier of the parent team for hierarchical organization
  - `permissions` object — Permissions of the resource Team
    - `services` integer[]
  - `position` integer — Position of the team in hierarchical structure
  - `products` object[], nullable
    - `id` integer — Unique identifier of the resource `{name}`
    - `rights` string[]

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadTeam
    - `id` integer, required — Unique identifier of the resource `Team`
    - `name` string, required — Name of the resource `Team`
    - `color_id` integer, required — Unique identifier of the `color` of the resource `Team`
    - `owned_by_id` string, required — Unique identifier of the `user` that owned the resource `Team`
    - `created_by_id` integer, nullable, required — Unique identifier of the `user` that created the resource `Team`
    - `created_at` integer, required — Timestamp `Team` has been created
    - `updated_at` integer, required — Timestamp `Team` has been updated
    - `created_by` 087adaadUser
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `owned_by` 087adaadUser
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `user_count` integer — User count related to the resource `Team`
    - `product_count` integer — Product count related to the resource `Team`
    - `product_by_service_count` integer — Product by service count related to the resource `Team`
    - `description` string, nullable, required — Description of the resource `Team`
    - `parent_id` integer, nullable, required
    - `logo` string, required
    - `position` integer, required
    - `children` 087adaadTeam[], required
    - `owners` 087adaadUser[]
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `is_sso` boolean, required
    - `permissions` 087adaadServicepermissions[], required
      - `service_id` integer, required — Unique identifier of the `service` that is related to the resource `Service permissions`
      - `service_name` string, required — Name of the service
      - `rights` 'check' | 'linked' | 'sale' | 'statistic' | 'technical', required
    - `products` 087adaadProductTeamPermissions[]
      - `product_unique_id` integer, required
      - `service_id` integer, required — Unique identifier of the `service` that is related to the resource `Product Team Permissions`
      - `product_id` integer, required — Unique identifier of the `product` that is related to the resource `Product Team Permissions`
      - `product_name` string, required
      - `rights` string[], required
    - `users` 087adaadUser[]
      - `id` integer, required — Unique identifier of the resource `User`
      - `display_name` string, required — Display name
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `email` string, required — Email
      - `is_sso` boolean, required — returns true if the user is provided by an external IDP
      - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
      - `type` string
    - `app_access` object
      - `mail` object, required
        - `mailboxes` unknown[], required
          - unknown
      - `drive` object, required
        - `folders` unknown[], required
          - unknown
      - `kchat` object, required
        - `channels` unknown[], required
          - unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-14** `8c78546bf41f` — 2 breaking, 1 warning, 11 info
  - the response property `allOf[subschema #2]/data/owners` became optional for the status `200`
  - the `allOf[subschema #2]/data/owned_by_id` response's property type changed from `integer` to `string` for status `200`
  - removed the request property `color`
  - added the new optional request property `color_id`
  - …10 more

[Change history](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/changes/1/accounts/:account/teams/:team/patch.md)

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/revisions/64c14a5addb7?raw)