Method: projects.topics.patch

Updates an existing topic by updating the fields specified in the update mask. Note that certain properties of a topic are not modifiable.

HTTP request

Path parameters



Required. Name of the topic. Format is projects/{project}/topics/{topic}.

Request body

The request body contains data with the following structure:

JSON representation
  "topic": {
    "name": string,
    "labels": {
      string: string,
    "messageStoragePolicy": {
      "allowedPersistenceRegions": [
      "enforceInTransit": boolean
    "kmsKeyName": string,
    "schemaSettings": {
      "schema": string,
      "encoding": enum (Encoding),
      "firstRevisionId": string,
      "lastRevisionId": string
    "satisfiesPzs": boolean,
    "messageRetentionDuration": string,
    "state": enum (State),
    "ingestionDataSourceSettings": {

      // Union field source can be only one of the following:
      "awsKinesis": {
        object (AwsKinesis)
      // End of list of possible types for union field source.
  "updateMask": string

map (key: string, value: string)

Optional. See Creating and managing labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.


object (MessageStoragePolicy)

Optional. Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.



Optional. The resource name of the Cloud KMS CryptoKey to be used to protect access to messages published on this topic.

The expected format is projects/*/locations/*/keyRings/*/cryptoKeys/*.


object (SchemaSettings)

Optional. Settings for validating messages published against a schema.



Optional. Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests.


string (Duration format)

Optional. Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last messageRetentionDuration are always available to subscribers. For instance, it allows any attached subscription to seek to a timestamp that is up to messageRetentionDuration in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 31 days or less than 10 minutes.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".


enum (State)

Output only. An output-only field indicating the state of the topic.


object (IngestionDataSourceSettings)

Optional. Settings for ingestion from a data source into this topic.


string (FieldMask format)

Required. Indicates which fields in the provided topic to update. Must be specified and non-empty. Note that if updateMask contains "messageStoragePolicy" but the messageStoragePolicy is not set in the topic provided above, then the updated value is determined by the policy configured at the project or organization level.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.