Skip to main content

flow list

Lists Power Automate flow in the given environment

Usage​

m365 flow list [options]

Options​

-e, --environmentName <environmentName>

The name of the environment for which to retrieve available flows

--asAdmin

Set, to list all Flows as admin. Otherwise will return only your own flows

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

caution

This command is based on an API that is currently in preview and is subject to change once the API reached general availability.

If the environment with the name you specified doesn't exist, you will get the Access to the environment 'xyz' is denied. error.

By default, the flow list command returns only your flows. To list all flows, use the asAdmin option.

Examples​

List all your flows in the given environment

m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5

List all flows in the given environment

m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin

Response​

Standard response​

[
  {
    "name": "00afcb83-df7b-4fe0-ab9c-1542a1dc66a9",
    "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9",
    "type": "Microsoft.ProcessSimple/environments/flows",
    "properties": {
      "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
      "displayName": "Contoso Invoicing Flow",
      "userType": "Owner",
      "state": "Started",
      "connectionReferences": {
        "shared_contoso-20invoicing-5fdd00e4805bfffb8f-5fbaee43593a7efda0": {
          "connectionName": "bd877f62e4224011aa936d706fc68902",
          "source": "Invoker",
          "id": "/providers/Microsoft.PowerApps/apis/shared_contoso-20invoicing-5fdd00e4805bfffb8f-5fbaee43593a7efda0",
          "displayName": "Contoso Invoicing",
          "iconUri": "https://az787822.vo.msecnd.net/defaulticons/api-dedicated.png",
          "brandColor": "#007ee5",
          "tier": "NotSpecified"
        },
        "shared_flowpush": {
          "connectionName": "shared-flowpush-d2c01136-3f7d-4449-b4f1-cb2d03a35ba8",
          "source": "Invoker",
          "id": "/providers/Microsoft.PowerApps/apis/shared_flowpush",
          "displayName": "Notifications",
          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1599/1.0.1599.3017/flowpush/icon.png",
          "brandColor": "#FF3B30",
          "tier": "Standard"
        }
      },
      "createdTime": "2022-06-11T10:34:03.7241198Z",
      "lastModifiedTime": "2022-06-11T10:35:54.1920032Z",
      "environment": {
        "name": "Default-00000000-0000-0000-0000-000000000000",
        "type": "Microsoft.ProcessSimple/environments",
        "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000"
      },
      "definitionSummary": {
        "triggers": [
          {
            "type": "Request",
            "kind": "Button",
            "metadata": {
              "operationMetadataId": "0cc0490e-e1b6-4a19-b313-f54862d64f02"
            }
          }
        ],
        "actions": [
          {
            "type": "OpenApiConnection",
            "swaggerOperationId": "ListInvoices",
            "metadata": {
              "operationMetadataId": "d76a7b54-48bb-49a0-86b8-dd3d21b3d5ce"
            }
          },
          {
            "type": "Table",
            "metadata": {
              "operationMetadataId": "1164ebc4-b501-46bc-bc88-cc99660f92c3"
            }
          },
          {
            "type": "OpenApiConnection",
            "swaggerOperationId": "SendEmailNotification",
            "metadata": {
              "operationMetadataId": "9febe29f-2e36-4765-81ab-83645d28332d"
            }
          }
        ]
      },
      "creator": {
        "tenantId": "00000000-0000-0000-0000-000000000000",
        "objectId": "00000000-0000-0000-0000-000000000000",
        "userId": "00000000-0000-0000-0000-000000000000",
        "userType": "ActiveDirectory"
      },
      "provisioningMethod": "FromDefinition",
      "flowFailureAlertSubscribed": true,
      "isManaged": false
    },
    "displayName": "Contoso Invoicing Flow"
  }
]