Update schemaExtension

Namespace: microsoft.graph

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.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Application.ReadWrite.All, Directory.AccessAsUser.All
Delegated (personal Microsoft account) Not supported.
Application Not supported.


Additionally for the delegated flow, the signed-in user can only update schemaExtensions they own (where the owner property of the schemaExtension is the appId of an application the signed-in user owns).

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 and Available to Deprecated.
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.



Here is an example of the request.

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

  "properties": [
HTTP/1.1 204 No Content

See also