Method: projects.locations.agents.flows.get

Retrieves the specified flow.

HTTP request

GET https://{endpoint}/v3beta1/{name=projects/*/locations/*/agents/*/flows/*}

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

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The name of the flow to get. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>.

Authorization requires the following IAM permission on the specified resource name:

  • dialogflow.flows.get

Query parameters



The language to retrieve the flow for. The following fields are language dependent:

  • 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 must be empty.

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.