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

PATCH https://{endpoint}/v3beta1/{*/locations/*/agents/*/intents/*}

Where {endpoint} is one of the supported service endpoints.

The URLs use 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.