The list of fields to be updated. All possible fields can be updated by passing *, or a subset of the following updateable fields can be provided:
agentId
languageCode
labels
metadata
qualityMetadata
callMetadata
startTime
expireTime or ttl
dataSource.gcs_source.audio_uri or dataSource.dialogflow_source.audio_uri
This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
allowMissing
boolean
Optional. Defaults to false. If set to true, and the conversation is not found, a new conversation will be created. In this situation, updateMask is ignored.
Request body
The request body contains an instance of Conversation.
Response body
If successful, the response body contains an instance of Conversation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-30 UTC."],[[["\u003cp\u003eThis webpage details how to update a conversation using a PATCH HTTP request to a specific endpoint with a predefined conversation name format.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eupdateMask\u003c/code\u003e query parameter is used to specify which fields within the conversation are to be updated, supporting a wide range of fields for modification.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003eConversation\u003c/code\u003e instance, which is also the format of the successful response.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a conversation requires the \u003ccode\u003econtactcenterinsights.conversations.update\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003ePath parameters are used for the immutable resource name of the conversation, and the request endpoint is defined by the supported service endpoint.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.conversations.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nUpdates a conversation.\n\n### HTTP request\n\n`PATCH https://{endpoint}/v1alpha1/{conversation.name=projects/*/locations/*/conversations/*}`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/contact-center/insights/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Conversation](/contact-center/insights/docs/reference/rest/v1alpha1/projects.locations.authorizedViewSets.authorizedViews.conversations#Conversation).\n\n### Response body\n\nIf successful, the response body contains an instance of [Conversation](/contact-center/insights/docs/reference/rest/v1alpha1/projects.locations.authorizedViewSets.authorizedViews.conversations#Conversation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires **one of** the following [IAM](https://cloud.google.com/iam/docs) permissions on the `name` resource, depending on the resource type:\n\n- `contactcenterinsights.authorizedConversations.update`\n- `contactcenterinsights.conversations.update`\n- `contactcenterinsights.datasetConversations.update`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
