Method: organizations.update

Stay organized with collections Save and categorize content based on your preferences.

Updates an Organization resource identified by the specified resource name.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Output only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organizationId]". For example, "organizations/1234".

Request body

The request body contains data with the following structure:

JSON representation
  "organizationId": string,
  "displayName": string,
  "owner": {
    object (OrganizationOwner)
  "creationTime": string,
  "lifecycleState": enum (LifecycleState)


An immutable id for the Organization that is assigned on creation. This should be omitted when creating a new Organization. This field is read-only.



A human-readable string that refers to the Organization in the GCP Console UI. This string is set by the server and cannot be changed. The string will be set to the primary domain (for example, "") of the G Suite customer that owns the organization.


object (OrganizationOwner)

The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required.


string (Timestamp format)

Timestamp when the Organization was created. Assigned by the server.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".


enum (LifecycleState)

The organization's current lifecycle state. Assigned by the server.

Response body

If successful, the response body contains an instance of Organization.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.