Method: projects.locations.agents.flows.patch

Updates the specified flow.

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

HTTP request

PATCH https://{endpoint}/v3/{*/locations/*/agents/*/flows/*}

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

The URLs use gRPC Transcoding syntax.

Path parameters



The unique identifier of the flow. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>.

Query parameters


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



The language of the following fields in flow:

  • Flow.event_handlers.trigger_fulfillment.messages
  • Flow.event_handlers.trigger_fulfillment.conditional_cases
  • Flow.transition_routes.trigger_fulfillment.messages
  • Flow.transition_routes.trigger_fulfillment.conditional_cases

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.

Request body

The request body contains an instance of Flow.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.