Update educationschool properties

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 the properties of a school object.


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) Not supported.
Delegated (personal Microsoft account) Not supported.
Application EduRoster.ReadWrite.All

HTTP request

PATCH /education/schools/{id}

Request headers

Header Value
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, don't include existing values that haven't changed.

Property Type Description
displayName String Display name of the school
description String Description of the school
principalEmail String Email address of the principal
principalName String Name of the principal
externalPrincipalId String Id of principal in syncing system.
highestGrade String Highest grade taught.
lowestGrade String Lowest grade taught.
schoolNumber String School Number.
externalId String Id of school in syncing system.
phone String Phone number of school.
fax String Fax number of school.
address physicalAddress Address of the School.
createdBy identitySet Entity who created the school.


If successful, this method returns a 200 OK response code and an updated educationSchool object in the response body.



The following is an example of the request.

PATCH https://graph.microsoft.com/beta/education/schools/10002
Content-type: application/json
Content-length: 292

  "displayName": "Fabrikam Arts High School",
  "description": "Magnate school for the arts. Los Angeles School District"

The following is an example of the response.

Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 292

  "id": "10002",
  "displayName": "Fabrikam Arts High School",
  "description": "Magnate school for the arts. Los Angeles School District",
  "status": "String",
  "externalSource": "String",
  "principalEmail": "AmyR@fabrikam.com",
  "principalName": "Amy Roebuck",
  "externalPrincipalId": "14007",
  "highestGrade": "12",
  "lowestGrade": "9",
  "schoolNumber": "10002",
  "address": {
    "city": "Los Angeles",
    "countryOrRegion": "United States",
    "postalCode": "98055",
    "state": "CA",
    "street": "12345 Main St."
  "externalId": "10002",
  "fax": "+1 (253) 555-0101",
  "phone": "+1 (253) 555-0102"