title	Update team
description	Update the properties of the specified team.
author	MSFTRickyCastaneda
ms.localizationpriority	medium
ms.subservice	teams
doc_type	apiPageType
ms.date	09/16/2024

Update team

Namespace: microsoft.graph

Update the properties of the specified team.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of.

[!INCLUDE permissions-table]

Note

The TeamSettings.ReadWrite.Group permission uses resource-specific consent.
The Group.ReadWrite.All and Directory.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.

HTTP request

PATCH /teams/{team-id}

Request headers

Header	Value
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json

Request body

In the request body, supply a JSON representation of team object.

Response

If successful, this method returns a 204 No Content response code.

Example

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/v1.0/teams/{id}
Content-type: application/json

{  
  "memberSettings": {
    "allowCreateUpdateChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict"
  }
}