Update organization

Update the properties of the currently authenticated organization.

Prerequisites

One of the following scopes is required to execute this API:

HTTP request

PATCH /organization

Request headers

Name Type Description
Authorization string Bearer . Required.

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
assignedPlans AssignedPlan The collection of service plans associated with the tenant. Notes: not nullable.
city String
companyLastDirSyncTime DateTimeOffset The time and date at which the tenant was last synced with the on-premise directory.
country String
countryLetterCode String
deletionTimestamp DateTimeOffset
dirSyncEnabled Boolean true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default).
displayName String The display name for the tenant.
marketingNotificationEmails String Notes: not nullable.
objectType String A string that identifies the object type. For tenants the value is always “Company”. Inherited from directoryObject.
postalCode String
preferredLanguage String
provisionedPlans ProvisionedPlan Notes: not nullable.
provisioningErrors ProvisioningError Notes: not nullable.
securityComplianceNotificationMails String
securityComplianceNotificationPhones String
state String
street String
technicalNotificationMails String Notes: not nullable.
telephoneNumber String
verifiedDomains VerifiedDomain The collection of domains associated with this tenant. Notes: not nullable.

Response

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

Example

Request

Here is an example of the request.

PATCH https://graph.microsoft.com/beta/organization
Content-type: application/json
Content-length: 411

{
  "assignedPlans": [
    {
      "assignedDateTime": "2016-10-19T10:37:00Z",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "servicePlanId-value"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "country": "country-value",
  "countryLetterCode": "countryLetterCode-value",
  "displayName": "displayName-value"
}
Response

Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "assignedPlans": [
    {
      "assignedDateTime": "2016-10-19T10:37:00Z",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "servicePlanId-value"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "country": "country-value",
  "countryLetterCode": "countryLetterCode-value",
  "displayName": "displayName-value"
}