{
 "openapi": "3.0.1",
 "info": {
  "title": "Cisco Meraki Dashboard API \u2014 insight",
  "description": "The insight operations of the Cisco Meraki Dashboard API, split by product area from Cisco's published OpenAPI definition.",
  "version": "1.72.0",
  "contact": {
   "name": "Meraki Developer Community",
   "url": "https://meraki.io/community"
  },
  "x-provenance": {
   "method": "harvested",
   "authored_by": "Cisco Meraki",
   "harvested_by": "API Evangelist",
   "harvested_on": "2026-07-31",
   "first_party": true,
   "note": "Split by first tag from Cisco's published spec3.json; operations unmodified.",
   "provider_published": true
  },
  "x-evidence": [
   {
    "type": "source",
    "url": "https://github.com/meraki/openapi/blob/master/openapi/spec3.json"
   },
   {
    "type": "raw",
    "url": "https://raw.githubusercontent.com/meraki/openapi/master/openapi/spec3.json"
   },
   {
    "type": "alternate",
    "url": "https://api.meraki.com/api/v1/openapiSpec"
   }
  ]
 },
 "servers": [
  {
   "url": "https://api.meraki.com/{basePath}",
   "variables": {
    "basePath": {
     "default": "api/v1"
    }
   }
  }
 ],
 "security": [
  {
   "meraki_api_key": []
  },
  {
   "bearerAuth": []
  }
 ],
 "tags": [
  {
   "name": "applications",
   "description": ""
  },
  {
   "name": "configure",
   "description": ""
  },
  {
   "name": "healthByTime",
   "description": ""
  },
  {
   "name": "insight",
   "description": ""
  },
  {
   "name": "monitor",
   "description": ""
  },
  {
   "name": "monitoredMediaServers",
   "description": ""
  }
 ],
 "components": {
  "securitySchemes": {
   "meraki_api_key": {
    "type": "apiKey",
    "name": "X-Cisco-Meraki-API-Key",
    "in": "header"
   },
   "bearerAuth": {
    "type": "http",
    "scheme": "bearer",
    "bearerFormat": "API Key"
   }
  }
 },
 "paths": {
  "/networks/{networkId}/insight/applications/{applicationId}/healthByTime": {
   "get": {
    "description": "Get application health by time",
    "operationId": "getNetworkInsightApplicationHealthByTime",
    "parameters": [
     {
      "name": "networkId",
      "in": "path",
      "description": "Network ID",
      "schema": {
       "type": "string"
      },
      "required": true
     },
     {
      "name": "applicationId",
      "in": "path",
      "description": "Application ID",
      "schema": {
       "type": "string"
      },
      "required": true
     },
     {
      "name": "t0",
      "in": "query",
      "description": "The beginning of the timespan for the data. The maximum lookback period is 7 days from today.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "t1",
      "in": "query",
      "description": "The end of the timespan for the data. t1 can be a maximum of 7 days after t0.",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "timespan",
      "in": "query",
      "description": "The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. The default is 2 hours.",
      "schema": {
       "type": "number",
       "format": "float",
       "maximum": 604800
      }
     },
     {
      "name": "resolution",
      "in": "query",
      "description": "The time resolution in seconds for returned data. The valid resolutions are: 60, 300, 3600, 86400. The default is 300.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful operation",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "startTs": {
            "type": "string",
            "format": "date-time",
            "description": "The start time of the query range"
           },
           "endTs": {
            "type": "string",
            "format": "date-time",
            "description": "The end time of the query range"
           },
           "wanGoodput": {
            "type": "integer",
            "description": "WAN goodput (Number of useful information bits delivered over a WAN per unit of time)"
           },
           "lanGoodput": {
            "type": "integer",
            "description": "LAN goodput (Number of useful information bits delivered over a LAN per unit of time)"
           },
           "wanLatencyMs": {
            "type": "number",
            "format": "float",
            "description": "WAN latency in milliseconds"
           },
           "lanLatencyMs": {
            "type": "number",
            "format": "float",
            "description": "LAN latency in milliseconds"
           },
           "wanLossPercent": {
            "type": "number",
            "format": "float",
            "description": "WAN loss percentage"
           },
           "lanLossPercent": {
            "type": "number",
            "format": "float",
            "description": "LAN loss percentage"
           },
           "responseDuration": {
            "type": "integer",
            "description": "Duration of the response, in milliseconds"
           },
           "sent": {
            "type": "integer",
            "description": "Sent kilobytes-per-second"
           },
           "recv": {
            "type": "integer",
            "description": "Received kilobytes-per-second"
           },
           "numClients": {
            "type": "integer",
            "description": "Number of clients"
           }
          }
         }
        },
        "example": [
         {
          "startTs": "2018-02-11T00:00:00Z",
          "endTs": "2018-05-12T00:00:00Z",
          "wanGoodput": 20000000,
          "lanGoodput": 100000000,
          "wanLatencyMs": 10.1,
          "lanLatencyMs": 3.2,
          "wanLossPercent": 0.2,
          "lanLossPercent": 0.0,
          "responseDuration": 210,
          "sent": 1000,
          "recv": 5000,
          "numClients": 2
         }
        ]
       }
      }
     }
    },
    "security": [
     {
      "oauth2": [
       "sdwan:telemetry:read"
      ]
     }
    ],
    "summary": "Get application health by time",
    "tags": [
     "insight",
     "monitor",
     "applications",
     "healthByTime"
    ]
   }
  },
  "/organizations/{organizationId}/insight/applications": {
   "get": {
    "description": "List all Insight tracked applications",
    "operationId": "getOrganizationInsightApplications",
    "parameters": [
     {
      "name": "organizationId",
      "in": "path",
      "description": "Organization ID",
      "schema": {
       "type": "string"
      },
      "required": true
     }
    ],
    "responses": {
     "200": {
      "description": "Successful operation",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "applicationId": {
            "type": "string",
            "description": "Application identifier"
           },
           "name": {
            "type": "string",
            "description": "Application name"
           },
           "thresholds": {
            "type": "object",
            "properties": {
             "type": {
              "type": "string",
              "description": "Threshold type (static or smart)"
             },
             "byNetwork": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "networkId": {
                 "type": "string",
                 "description": "Network identifier"
                },
                "goodput": {
                 "type": "integer",
                 "description": "Number of useful information bits delivered over a network per unit of time"
                },
                "responseDuration": {
                 "type": "integer",
                 "description": "Duration of the response, in milliseconds"
                }
               }
              },
              "description": "Threshold for each network"
             }
            },
            "description": "Thresholds defined by a user or Meraki models for each application"
           }
          }
         }
        },
        "example": [
         {
          "applicationId": "19.12",
          "name": "Meraki HTTPS",
          "thresholds": {
           "type": "smart",
           "byNetwork": [
            {
             "networkId": "N_12345678",
             "goodput": 50000,
             "responseDuration": 1000
            }
           ]
          }
         }
        ]
       }
      }
     }
    },
    "security": [
     {
      "oauth2": [
       "sdwan:telemetry:read"
      ]
     }
    ],
    "summary": "List all Insight tracked applications",
    "tags": [
     "insight",
     "configure",
     "applications"
    ]
   }
  },
  "/organizations/{organizationId}/insight/monitoredMediaServers": {
   "get": {
    "description": "List the monitored media servers for this organization. Only valid for organizations with Meraki Insight.",
    "operationId": "getOrganizationInsightMonitoredMediaServers",
    "parameters": [
     {
      "name": "organizationId",
      "in": "path",
      "description": "Organization ID",
      "schema": {
       "type": "string"
      },
      "required": true
     }
    ],
    "responses": {
     "200": {
      "description": "Successful operation",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "id": {
            "type": "string",
            "description": "Monitored media server id"
           },
           "name": {
            "type": "string",
            "description": "The name of the VoIP provider"
           },
           "address": {
            "type": "string",
            "description": "The IP address (IPv4 only) or hostname of the media server to monitor"
           },
           "bestEffortMonitoringEnabled": {
            "type": "boolean",
            "description": "Indicates that if the media server doesn't respond to ICMP pings, the nearest hop will be used in its stead"
           }
          }
         }
        },
        "example": [
         {
          "id": "1284392014819",
          "name": "Sample VoIP Provider",
          "address": "123.123.123.1",
          "bestEffortMonitoringEnabled": true
         }
        ]
       }
      }
     }
    },
    "summary": "List the monitored media servers for this organization",
    "tags": [
     "insight",
     "configure",
     "monitoredMediaServers"
    ]
   },
   "post": {
    "description": "Add a media server to be monitored for this organization. Only valid for organizations with Meraki Insight.",
    "operationId": "createOrganizationInsightMonitoredMediaServer",
    "parameters": [
     {
      "name": "organizationId",
      "in": "path",
      "description": "Organization ID",
      "schema": {
       "type": "string"
      },
      "required": true
     }
    ],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string",
          "description": "The name of the VoIP provider"
         },
         "address": {
          "type": "string",
          "description": "The IP address (IPv4 only) or hostname of the media server to monitor"
         },
         "bestEffortMonitoringEnabled": {
          "type": "boolean",
          "description": "Indicates that if the media server doesn't respond to ICMP pings, the nearest hop will be used in its stead."
         }
        },
        "example": {
         "name": "Sample VoIP Provider",
         "address": "123.123.123.1",
         "bestEffortMonitoringEnabled": true
        },
        "required": [
         "name",
         "address"
        ]
       }
      }
     },
     "required": true
    },
    "responses": {
     "201": {
      "description": "Successful operation",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string",
           "description": "Monitored media server id"
          },
          "name": {
           "type": "string",
           "description": "The name of the VoIP provider"
          },
          "address": {
           "type": "string",
           "description": "The IP address (IPv4 only) or hostname of the media server to monitor"
          },
          "bestEffortMonitoringEnabled": {
           "type": "boolean",
           "description": "Indicates that if the media server doesn't respond to ICMP pings, the nearest hop will be used in its stead"
          }
         }
        },
        "example": {
         "id": "1284392014819",
         "name": "Sample VoIP Provider",
         "address": "123.123.123.1",
         "bestEffortMonitoringEnabled": true
        }
       }
      }
     }
    },
    "summary": "Add a media server to be monitored for this organization",
    "tags": [
     "insight",
     "configure",
     "monitoredMediaServers"
    ]
   }
  },
  "/organizations/{organizationId}/insight/monitoredMediaServers/{monitoredMediaServerId}": {
   "get": {
    "description": "Return a monitored media server for this organization. Only valid for organizations with Meraki Insight.",
    "operationId": "getOrganizationInsightMonitoredMediaServer",
    "parameters": [
     {
      "name": "organizationId",
      "in": "path",
      "description": "Organization ID",
      "schema": {
       "type": "string"
      },
      "required": true
     },
     {
      "name": "monitoredMediaServerId",
      "in": "path",
      "description": "Monitored media server ID",
      "schema": {
       "type": "string"
      },
      "required": true
     }
    ],
    "responses": {
     "200": {
      "description": "Successful operation",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string",
           "description": "Monitored media server id"
          },
          "name": {
           "type": "string",
           "description": "The name of the VoIP provider"
          },
          "address": {
           "type": "string",
           "description": "The IP address (IPv4 only) or hostname of the media server to monitor"
          },
          "bestEffortMonitoringEnabled": {
           "type": "boolean",
           "description": "Indicates that if the media server doesn't respond to ICMP pings, the nearest hop will be used in its stead"
          }
         }
        },
        "example": {
         "id": "1284392014819",
         "name": "Sample VoIP Provider",
         "address": "123.123.123.1",
         "bestEffortMonitoringEnabled": true
        }
       }
      }
     }
    },
    "summary": "Return a monitored media server for this organization",
    "tags": [
     "insight",
     "configure",
     "monitoredMediaServers"
    ]
   },
   "put": {
    "description": "Update a monitored media server for this organization. Only valid for organizations with Meraki Insight.",
    "operationId": "updateOrganizationInsightMonitoredMediaServer",
    "parameters": [
     {
      "name": "organizationId",
      "in": "path",
      "description": "Organization ID",
      "schema": {
       "type": "string"
      },
      "required": true
     },
     {
      "name": "monitoredMediaServerId",
      "in": "path",
      "description": "Monitored media server ID",
      "schema": {
       "type": "string"
      },
      "required": true
     }
    ],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string",
          "description": "The name of the VoIP provider"
         },
         "address": {
          "type": "string",
          "description": "The IP address (IPv4 only) or hostname of the media server to monitor"
         },
         "bestEffortMonitoringEnabled": {
          "type": "boolean",
          "description": "Indicates that if the media server doesn't respond to ICMP pings, the nearest hop will be used in its stead."
         }
        },
        "example": {
         "name": "Sample VoIP Provider",
         "address": "123.123.123.1",
         "bestEffortMonitoringEnabled": true
        }
       }
      }
     },
     "required": false
    },
    "responses": {
     "200": {
      "description": "Successful operation",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string",
           "description": "Monitored media server id"
          },
          "name": {
           "type": "string",
           "description": "The name of the VoIP provider"
          },
          "address": {
           "type": "string",
           "description": "The IP address (IPv4 only) or hostname of the media server to monitor"
          },
          "bestEffortMonitoringEnabled": {
           "type": "boolean",
           "description": "Indicates that if the media server doesn't respond to ICMP pings, the nearest hop will be used in its stead"
          }
         }
        },
        "example": {
         "id": "1284392014819",
         "name": "Sample VoIP Provider",
         "address": "123.123.123.1",
         "bestEffortMonitoringEnabled": true
        }
       }
      }
     }
    },
    "summary": "Update a monitored media server for this organization",
    "tags": [
     "insight",
     "configure",
     "monitoredMediaServers"
    ]
   },
   "delete": {
    "description": "Delete a monitored media server from this organization. Only valid for organizations with Meraki Insight.",
    "operationId": "deleteOrganizationInsightMonitoredMediaServer",
    "parameters": [
     {
      "name": "organizationId",
      "in": "path",
      "description": "Organization ID",
      "schema": {
       "type": "string"
      },
      "required": true
     },
     {
      "name": "monitoredMediaServerId",
      "in": "path",
      "description": "Monitored media server ID",
      "schema": {
       "type": "string"
      },
      "required": true
     }
    ],
    "responses": {
     "204": {
      "description": "Successful operation"
     }
    },
    "summary": "Delete a monitored media server from this organization",
    "tags": [
     "insight",
     "configure",
     "monitoredMediaServers"
    ]
   }
  }
 }
}