Authorization requires the following IAM permission on the specified resource parent:
dialogflow.intents.batchUpdate
Request body
The request body contains data with the following structure:
JSON representation
{"languageCode": string,"updateMask": string,"intentView": enum (IntentView),// Union field intent_batch can be only one of the following:"intentBatchUri": string,"intentBatchInline": {object (IntentBatch)}// End of list of possible types for union field intent_batch.}
Fields
languageCode
string
Optional. The language used to access language-specific data. If not specified, the agent's default language is used. For more information, see Multilingual intent and entity data.
Optional. The resource view to apply to the returned intent.
Union field intent_batch. Required. The source of the intent batch.
For each intent in the batch:
If name is specified, we update an existing intent.
If name is not specified, we create a new intent. intent_batch can be only one of the following:
intentBatchUri
string
The URI to a Google Cloud Storage file containing intents to update or create. The file format can either be a serialized proto (of IntentBatch type) or JSON object. Note: The URI must start with "gs://".
[[["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-06-27 UTC."],[[["\u003cp\u003eThis operation updates or creates multiple intents within a specified agent using a long-running process.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made via a \u003ccode\u003ePOST\u003c/code\u003e HTTP method to a specified endpoint, using gRPC Transcoding syntax for the URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires details on the intent batch source, which can be a Google Cloud Storage file URI or an inline collection of intents.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required and specifies the agent in which to perform updates or creations, requiring \u003ccode\u003edialogflow.intents.batchUpdate\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.agent.intents.batchUpdate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates/Creates multiple intents in the specified agent.\n\nThis method is a [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned `Operation` type has the following method-specific fields:\n\n- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)\n- `response`: [BatchUpdateIntentsResponse](/dialogflow/es/docs/reference/rest/v2beta1/BatchUpdateIntentsResponse)\n\nNote: You should always train an agent prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/es/docs/training).\n\n### HTTP request\n\n`POST https://{endpoint}/v2beta1/{parent=projects/*/agent}/intents:batchUpdate`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/dialogflow/es/docs/reference/rest/v2beta1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
