---
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` integer
  - `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
  - `permissions` object — Permissions of the resource Team
    - `services` integer[]

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadTeam2a133770
    - `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` integer, nullable, 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`
    - `owners` 087adaadUser[], required
      - `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

---

[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-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)