Method: projects.locations.dataStores.conversations.patch

Updates a Conversation.

Conversation action type cannot be changed. If the Conversation to update does not exist, a NOT_FOUND error is returned.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Immutable. Fully qualified name project/*/locations/global/collections/{collection}/dataStore/*/conversations/*

Query parameters


string (FieldMask format)

Indicates which fields in the provided Conversation to update. The following are NOT supported:

  • [][]

If not set or empty, all supported fields are updated.

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

Request body

The request body contains an instance of Conversation.

Response body

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

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • discoveryengine.conversations.update

For more information, see the IAM documentation.