Method: projects.agent.intents.batchUpdate

Updates/Creates multiple intents in the specified agent.

Operation <response: BatchUpdateIntentsResponse>

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The name of the agent to update or create intents in. Format: projects/<Project ID>/agent.

Authorization requires the following Google 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.


Optional. The language of training phrases, parameters and rich messages defined in intents. If not specified, the agent's default language is used. Many languages are supported. Note: languages must be enabled in the agent before they can be used.


string (FieldMask format)

Optional. The mask to control which fields get updated.

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


enum (IntentView)

Optional. The resource view to apply to the returned intent.

Union field intent_batch. Required. The source of the intent batch. intent_batch can be only one of the following:


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://".


object (IntentBatch)

The collection of intents to update or create.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.

Try it!

Was this page helpful? Let us know how we did:

Send feedback about...

Need help? Visit our support page.