Update schemaExtension

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Update properties in the definition of the specified schemaExtension.

The update applies to all the resources that are included in the targetTypes property of the extension. These resources are among the supporting resource types.

Only the app that created a schema extension (owner app) can make additive updates to the extension when the extension is in the InDevelopment or Available status. That means the app cannot remove custom properties or target resource types from the definition. The app can, however, change the description of the extension.


The following scope is required to execute this API: Directory.AccessAsUser.All

HTTP request

PATCH /schemaExtensions/{id}

Optional request headers

Name Description
Authorization Bearer {token}. Required.
Content-Type application/json

Request body

In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

Property Type Description
description String Description for the schema extension.
properties extensionSchemaProperty collection The collection of property names and types that make up the schema extension definition. Only additive changes are permitted.
status String The lifecycle state of the schema extension. The initial state upon creation is InDevelopment. Possible states transitions are from InDevelopment to Available, Available to Deprecated and Deprecated to Available.
targetTypes String collection Set of Microsoft Graph types (that can support extensions) that the schema extension can be applied to. Only additive changes are permitted.


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


PATCH https://graph.microsoft.com/beta/schemaExtensions/{id}
Content-type: application/json
Content-length: 201

  "properties": [
HTTP/1.1 204 No Content

See also