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 endpoint uses a PATCH request to update a specific conversation resource using its name, following a defined format for resource identification.\u003c/p\u003e\n"],["\u003cp\u003eUpdates to the conversation can be done through the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter, allowing modification of specific fields, such as \u003ccode\u003eagentId\u003c/code\u003e, \u003ccode\u003elanguageCode\u003c/code\u003e, \u003ccode\u003elabels\u003c/code\u003e, and more, or updating everything by passing \u003ccode\u003e*\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should include a \u003ccode\u003eConversation\u003c/code\u003e instance, and a successful operation will return a \u003ccode\u003eConversation\u003c/code\u003e instance in the response body.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a conversation requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the \u003ccode\u003econtactcenterinsights.conversations.update\u003c/code\u003e IAM permission on the resource.\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}/v1/{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/v1/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/v1/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)."]]