Method: projects.locations.workflows.executions.list

Returns a list of executions which belong to the workflow with the given name. The method returns executions of all workflow revisions. Returned executions are ordered by their start time (newest first).

HTTP request

GET https://workflowexecutions.googleapis.com/v1beta/{parent=projects/*/locations/*/workflows/*}/executions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Name of the workflow for which the executions should be listed. Format: projects/{project}/locations/{location}/workflows/{workflow}

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

  • workflows.executions.list

Query parameters

Parameters
pageSize

integer

Maximum number of executions to return per call. Max supported value depends on the selected Execution view: it's 10000 for BASIC and 100 for FULL. The default value used if the field is not specified is 100, regardless of the selected view. Values greater than the max value will be coerced down to it.
pageToken

string

A page token, received from a previous executions.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to executions.list must match the call that provided the page token.
view

enum (ExecutionView)

Optional. A view defining which fields should be filled in the returned executions. The API will default to the BASIC view.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response for the executions.list method.

JSON representation 
{
  "executions": [
    {
      object (Execution)
    }
  ],
  "nextPageToken": string
}
Fields
executions[]

object (Execution)

The executions which match the request.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.