Skip to content

flow run list

Lists runs of the specified Microsoft Flow


m365 flow run list [options]


-f, --flowName <flowName>
The name of the Microsoft Flow to retrieve the runs for
-e, --environmentName <environmentName>
The name of the environment to which the flow belongs
-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 for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
Runs command with verbose logging
Runs command with debug logging



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.

If the Microsoft Flow with the name you specified doesn't exist, you will get the The caller with object id 'abc' does not have permission for connection 'xyz' under Api 'shared_logicflows'. error.


List runs of the specified Microsoft Flow

m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a


Standard response

    "name": "08585329112602833828909892130CU17",
    "id": "/providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17",
    "type": "Microsoft.ProcessSimple/environments/flows/runs",
    "properties": {
      "startTime": "2022-11-17T14:33:45.2763872Z",
      "status": "Running",
      "correlation": {
        "clientTrackingId": "08585329112602833829909892130CU00"
      "trigger": {
        "name": "When_a_new_response_is_submitted",
        "inputsLink": {
          "uri": "",
          "contentVersion": "6ZrBBE+MJg7IvhMgyJLMmA==",
          "contentSize": 349,
          "contentHash": {
            "algorithm": "md5",
            "value": "6ZrBBE+MJg7IvhMgyJLMmA=="
        "outputsLink": {
          "uri": "",
          "contentVersion": "Z/4a8tfYygNAR1xpc44iww==",
          "contentSize": 493,
          "contentHash": {
            "algorithm": "md5",
            "value": "Z/4a8tfYygNAR1xpc44iww=="
        "startTime": "2022-11-17T14:33:45.1914506Z",
        "endTime": "2022-11-17T14:33:45.1914506Z",
        "originHistoryName": "08585329112602833829909892130CU00",
        "correlation": {
          "clientTrackingId": "08585329112602833829909892130CU00"
        "status": "Succeeded"
    "startTime": "2022-11-17T14:33:45.2763872Z",
    "status": "Running"
name                               startTime                     status
---------------------------------  ----------------------------  ---------
08585329112602833828909892130CU17  2022-11-17T14:33:45.2763872Z  Running