Update organization

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 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 {token}. 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.

Since the organization resource supports extensions, you can use the PATCH operation to add, update, or delete your own app-specific data in custom properties of an extension in an existing organization instance.

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"
}

See also