Join the Dialogflow CX competition! Get trained in Dialogflow CX, work on open-source conversational components, get a free Dialogflow t-shirt and win cool prizes! Learn more.

Method: projects.locations.agents.intents.patch

Updates the specified intent.

Note: You should always train a flow prior to sending it queries. See the training documentation.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The unique identifier of the intent. Required for the Intents.UpdateIntent method. Intents.CreateIntent populates the name automatically. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/intents/<Intent ID>.

Query parameters



The language of the following fields in intent:


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)

The mask to control which fields get updated. If the mask is not present, all fields will be 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 Intent.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.