Cisco Meraki Networks API

The networks API from Cisco Meraki — 89 operation(s) for networks.

Operations 115

GET /networks/{networkId} Return a network #
PUT /networks/{networkId} Update a network #
DELETE /networks/{networkId} Delete a network #
GET /networks/{networkId}/alerts/history Return the alert history for this network #
GET /networks/{networkId}/alerts/settings Return the alert configuration for this network #
PUT /networks/{networkId}/alerts/settings Update the alert configuration for this network #
POST /networks/{networkId}/bind Bind a network to a template. #
GET /networks/{networkId}/bluetoothClients List the Bluetooth clients seen by APs in this network #
GET /networks/{networkId}/bluetoothClients/{bluetoothClientId} Return a Bluetooth client #
GET /networks/{networkId}/clients List the clients that have used this network in the timespan #
GET /networks/{networkId}/clients/applicationUsage Return the application usage data for clients #
GET /networks/{networkId}/clients/bandwidthUsageHistory Returns a timeseries of total traffic consumption rates for all clients on a network within a given timespan, in megabits per second. #
GET /networks/{networkId}/clients/overview Return overview statistics for network clients #
POST /networks/{networkId}/clients/provision Provisions a client with a name and policy #
GET /networks/{networkId}/clients/usageHistories Return the usage histories for clients #
GET /networks/{networkId}/clients/{clientId} Return the client associated with the given identifier #
GET /networks/{networkId}/clients/{clientId}/policy Return the policy assigned to a client on the network #
PUT /networks/{networkId}/clients/{clientId}/policy Update the policy assigned to a client on the network #
GET /networks/{networkId}/clients/{clientId}/splashAuthorizationStatus Return the splash authorization for a client, for each SSID they've associated with through splash #
PUT /networks/{networkId}/clients/{clientId}/splashAuthorizationStatus Update a client's splash authorization #
GET /networks/{networkId}/clients/{clientId}/trafficHistory Return the client's network traffic data over time #
GET /networks/{networkId}/clients/{clientId}/usageHistory Return the client's daily usage history #
GET /networks/{networkId}/devices List the devices in a network #
POST /networks/{networkId}/devices/claim Claim devices into a network. (Note: for recently claimed devices, it may take a few minutes for API requests against that device to succeed) #
POST /networks/{networkId}/devices/claim/vmx Claim a vMX into a network #
POST /networks/{networkId}/devices/remove Remove a single device #
PUT /networks/{networkId}/devices/syslog/servers Updates the syslog servers configuration for a network. #
GET /networks/{networkId}/events List the events for the network #
GET /networks/{networkId}/events/eventTypes List the event type to human-readable description #
GET /networks/{networkId}/firmwareUpgrades Get firmware upgrade information for a network #
PUT /networks/{networkId}/firmwareUpgrades Update firmware upgrade information for a network #
POST /networks/{networkId}/firmwareUpgrades/rollbacks Rollback a Firmware Upgrade For A Network #
GET /networks/{networkId}/firmwareUpgrades/staged/events Get the Staged Upgrade Event from a network #
POST /networks/{networkId}/firmwareUpgrades/staged/events Create a Staged Upgrade Event for a network #
PUT /networks/{networkId}/firmwareUpgrades/staged/events Update the Staged Upgrade Event for a network #
POST /networks/{networkId}/firmwareUpgrades/staged/events/defer Postpone by 1 week all pending staged upgrade stages for a network #
POST /networks/{networkId}/firmwareUpgrades/staged/events/rollbacks Rollback a Staged Upgrade Event for a network #
GET /networks/{networkId}/firmwareUpgrades/staged/groups List of Staged Upgrade Groups in a network #
POST /networks/{networkId}/firmwareUpgrades/staged/groups Create a Staged Upgrade Group for a network #
GET /networks/{networkId}/firmwareUpgrades/staged/groups/{groupId} Get a Staged Upgrade Group from a network #
PUT /networks/{networkId}/firmwareUpgrades/staged/groups/{groupId} Update a Staged Upgrade Group for a network #
DELETE /networks/{networkId}/firmwareUpgrades/staged/groups/{groupId} Delete a Staged Upgrade Group #
GET /networks/{networkId}/firmwareUpgrades/staged/stages Order of Staged Upgrade Groups in a network #
PUT /networks/{networkId}/firmwareUpgrades/staged/stages Assign Staged Upgrade Group order in the sequence. #
GET /networks/{networkId}/floorPlans List the floor plans that belong to your network #
POST /networks/{networkId}/floorPlans Upload a floor plan #
POST /networks/{networkId}/floorPlans/autoLocate/jobs/batch Schedule auto locate jobs for one or more floor plans in a network #
POST /networks/{networkId}/floorPlans/autoLocate/jobs/{jobId}/cancel Cancel a scheduled or running auto locate job #
POST /networks/{networkId}/floorPlans/autoLocate/jobs/{jobId}/publish Update the status of a finished auto locate job to be published, and update device locations #
POST /networks/{networkId}/floorPlans/autoLocate/jobs/{jobId}/recalculate Trigger auto locate recalculation for a job, and optionally set anchors #
POST /networks/{networkId}/floorPlans/devices/batchUpdate Update floorplan assignments for a batch of devices #
GET /networks/{networkId}/floorPlans/{floorPlanId} Find a floor plan by ID #
PUT /networks/{networkId}/floorPlans/{floorPlanId} Update a floor plan's geolocation and other meta data #
DELETE /networks/{networkId}/floorPlans/{floorPlanId} Destroy a floor plan #
GET /networks/{networkId}/groupPolicies List the group policies in a network #
POST /networks/{networkId}/groupPolicies Create a group policy #
GET /networks/{networkId}/groupPolicies/{groupPolicyId} Display a group policy #
PUT /networks/{networkId}/groupPolicies/{groupPolicyId} Update a group policy #
DELETE /networks/{networkId}/groupPolicies/{groupPolicyId} Delete a group policy #
GET /networks/{networkId}/health/alerts Return all global alerts on this network #
GET /networks/{networkId}/merakiAuthUsers List the authorized users configured under Meraki Authentication for a network (splash guest or RADIUS users for a wireless network, or client VPN users for a MX network) #
POST /networks/{networkId}/merakiAuthUsers Authorize a user configured with Meraki Authentication for a network (currently supports 802.1X, splash guest, and client VPN users, and currently, organizations have a 50,000 user #
GET /networks/{networkId}/merakiAuthUsers/{merakiAuthUserId} Return the Meraki Auth splash guest, RADIUS, or client VPN user #
DELETE /networks/{networkId}/merakiAuthUsers/{merakiAuthUserId} Delete an 802.1X RADIUS user, or deauthorize and optionally delete a splash guest or client VPN user. #
PUT /networks/{networkId}/merakiAuthUsers/{merakiAuthUserId} Update a user configured with Meraki Authentication (currently, 802.1X RADIUS, splash guest, and client VPN users can be updated) #
GET /networks/{networkId}/mqttBrokers List the MQTT brokers for this network #
POST /networks/{networkId}/mqttBrokers Add an MQTT broker #
GET /networks/{networkId}/mqttBrokers/{mqttBrokerId} Return an MQTT broker #
PUT /networks/{networkId}/mqttBrokers/{mqttBrokerId} Update an MQTT broker #
DELETE /networks/{networkId}/mqttBrokers/{mqttBrokerId} Delete an MQTT broker #
GET /networks/{networkId}/netflow Return the NetFlow traffic reporting settings for a network #
PUT /networks/{networkId}/netflow Update the NetFlow traffic reporting settings for a network #
GET /networks/{networkId}/networkHealth/channelUtilization Get the channel utilization over each radio for all APs in a network. #
GET /networks/{networkId}/pii/piiKeys List the keys required to access Personally Identifiable Information (PII) for a given identifier #
GET /networks/{networkId}/pii/requests List the PII requests for this network or organization #
POST /networks/{networkId}/pii/requests Submit a new delete or restrict processing PII request #
GET /networks/{networkId}/pii/requests/{requestId} Return a PII request #
DELETE /networks/{networkId}/pii/requests/{requestId} Delete a restrict processing PII request #
GET /networks/{networkId}/pii/smDevicesForKey Given a piece of Personally Identifiable Information (PII), return the Systems Manager device ID(s) associated with that identifier #
GET /networks/{networkId}/pii/smOwnersForKey Given a piece of Personally Identifiable Information (PII), return the Systems Manager owner ID(s) associated with that identifier #
GET /networks/{networkId}/policies/byClient Get policies for all clients with policies #
GET /networks/{networkId}/settings Return the settings for a network #
PUT /networks/{networkId}/settings Update the settings for a network #
GET /networks/{networkId}/snmp Return the SNMP settings for a network #
PUT /networks/{networkId}/snmp Update the SNMP settings for a network #
GET /networks/{networkId}/splashLoginAttempts List the splash login attempts for a network #
POST /networks/{networkId}/split Split a combined network into individual networks for each type of device #
GET /networks/{networkId}/syslogServers List the syslog servers for a network #
PUT /networks/{networkId}/syslogServers Update the syslog servers for a network #
GET /networks/{networkId}/topology/linkLayer List the LLDP and CDP information for all discovered devices and connections in a network #
GET /networks/{networkId}/traffic Return the traffic analysis data for this network #
GET /networks/{networkId}/trafficAnalysis Return the traffic analysis settings for a network #
PUT /networks/{networkId}/trafficAnalysis Update the traffic analysis settings for a network #
GET /networks/{networkId}/trafficShaping/applicationCategories Returns the application categories for traffic shaping rules #
GET /networks/{networkId}/trafficShaping/dscpTaggingOptions Returns the available DSCP tagging options for your traffic shaping rules. #
POST /networks/{networkId}/unbind Unbind a network from a template. #
GET /networks/{networkId}/vlanProfiles List VLAN profiles for a network #
POST /networks/{networkId}/vlanProfiles Create a VLAN profile for a network #
GET /networks/{networkId}/vlanProfiles/assignments/byDevice Get the assigned VLAN Profiles for devices in a network #
POST /networks/{networkId}/vlanProfiles/assignments/reassign Update the assigned VLAN Profile for devices in a network #
GET /networks/{networkId}/vlanProfiles/{iname} Get an existing VLAN profile of a network #
PUT /networks/{networkId}/vlanProfiles/{iname} Update an existing VLAN profile of a network #
DELETE /networks/{networkId}/vlanProfiles/{iname} Delete a VLAN profile of a network #
GET /networks/{networkId}/webhooks/httpServers List the HTTP servers for a network #
POST /networks/{networkId}/webhooks/httpServers Add an HTTP server to a network #
GET /networks/{networkId}/webhooks/httpServers/{httpServerId} Return an HTTP server for a network #
PUT /networks/{networkId}/webhooks/httpServers/{httpServerId} Update an HTTP server #
DELETE /networks/{networkId}/webhooks/httpServers/{httpServerId} Delete an HTTP server from a network #
GET /networks/{networkId}/webhooks/payloadTemplates List the webhook payload templates for a network #
POST /networks/{networkId}/webhooks/payloadTemplates Create a webhook payload template for a network #
GET /networks/{networkId}/webhooks/payloadTemplates/{payloadTemplateId} Get the webhook payload template for a network #
DELETE /networks/{networkId}/webhooks/payloadTemplates/{payloadTemplateId} Destroy a webhook payload template for a network #
PUT /networks/{networkId}/webhooks/payloadTemplates/{payloadTemplateId} Update a webhook payload template for a network #
POST /networks/{networkId}/webhooks/webhookTests Send a test webhook for a network #
GET /networks/{networkId}/webhooks/webhookTests/{webhookTestId} Return the status of a webhook test for a network #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cisco-meraki-networks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cisco-meraki-networks-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Meraki Dashboard Networks API
  description: 'A RESTful API to programmatically manage and monitor Cisco Meraki networks at scale.


    > Date: 05 August, 2026

    >

    > [Recent Updates](https://meraki.io/whats-new/)


    ---


    [API Documentation](https://meraki.io/api)


    [Community Support](https://meraki.io/community)


    [Meraki Homepage](https://www.meraki.com)

    '
  contact:
    name: Meraki Developer Community
    url: https://meraki.io/community
  version: 1.73.0
  x-provenance:
    method: harvested
    authored_by: Cisco Meraki
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    note: Published by Cisco. Retrieved unmodified except for this x-provenance block.
    provider_published: true
    derived_view: Per-first-tag view of the source document, tag 'networks'. Operations and schemas are the provider's, unmodified.
  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: networks
paths:
  /networks/{networkId}:
    get:
      description: Return a network
      operationId: getNetwork
      parameters:
      - name: networkId
        in: path
        description: Network ID
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Network ID
                  organizationId:
                    type: string
                    description: Organization ID
                  name:
                    type: string
                    description: Network name
                  productTypes:
                    type: array
                    items:
                      type: string
                    description: List of the product types that the network supports
                  timeZone:
                    type: string
                    description: Timezone of the network
                  tags:
                    type: array
                    items:
                      type: string
                    description: Network tags
                  enrollmentString:
                    type: string
                    description: Enrollment string for the network
                  url:
                    type: string
                    description: URL to the network Dashboard UI
                  notes:
                    type: string
                    description: Notes for the network
                  isBoundToConfigTemplate:
                    type: boolean
                    description: If the network is bound to a config template
              example:
                id: N_24329156
                organizationId: '2930418'
                name: Main Office
                productTypes:
                - appliance
                - switch
                - wireless
                timeZone: America/Los_Angeles
                tags:
                - tag1
                - tag2
                enrollmentString: my-enrollment-string
                url: https://n1.meraki.com//n//manage/nodes/list
                notes: Additional description of the network
                isBoundToConfigTemplate: false
      security:
      - oauth2:
        - dashboard:general:config:read
      summary: Return a network
      tags:
      - networks
    put:
      description: Update a network
      operationId: updateNetwork
      parameters:
      - name: networkId
        in: path
        description: Network ID
        schema:
          type: string
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: The name of the network
                timeZone:
                  type: string
                  description: The timezone of the network. For a list of allowed timezones, please see the 'TZ' column in the table in <a target='_blank' href='https://en.wikipedia.org/wiki/List_of_tz_database_time_zones'>this article.</a>
                tags:
                  type: array
                  items:
                    type: string
                  description: A list of tags to be applied to the network
                enrollmentString:
                  type: string
                  description: A unique identifier which can be used for device enrollment or easy access through the Meraki SM Registration page or the Self Service Portal. Please note that changing this field may cause existing bookmarks to break.
                notes:
                  type:
                  - string
                  - 'null'
                  description: Add any notes or additional information about this network here.
              example:
                name: Main Office
                timeZone: America/Los_Angeles
                tags:
                - tag1
                - tag2
                enrollmentString: my-enrollment-string
                notes: Additional description of the network
        required: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Network ID
                  organizationId:
                    type: string
                    description: Organization ID
                  name:
                    type: string
                    description: Network name
                  productTypes:
                    type: array
                    items:
                      type: string
                    description: List of the product types that the network supports
                  timeZone:
                    type: string
                    description: Timezone of the network
                  tags:
                    type: array
                    items:
                      type: string
                    description: Network tags
                  enrollmentString:
                    type: string
                    description: Enrollment string for the network
                  url:
                    type: string
                    description: URL to the network Dashboard UI
                  notes:
                    type: string
                    description: Notes for the network
                  isBoundToConfigTemplate:
                    type: boolean
                    description: If the network is bound to a config template
              example:
                id: N_24329156
                organizationId: '2930418'
                name: Main Office
                productTypes:
                - appliance
                - switch
                - wireless
                timeZone: America/Los_Angeles
                tags:
                - tag1
                - tag2
                enrollmentString: my-enrollment-string
                url: https://n1.meraki.com//n//manage/nodes/list
                notes: Additional description of the network
                isBoundToConfigTemplate: false
      security:
      - oauth2:
        - dashboard:general:config:write
      summary: Update a network
      tags:
      - networks
    delete:
      description: Delete a network
      operationId: deleteNetwork
      parameters:
      - name: networkId
        in: path
        description: Network ID
        schema:
          type: string
        required: true
      responses:
        '204':
          description: Successful operation
      security:
      - oauth2:
        - dashboard:general:config:write
      summary: Delete a network
      tags:
      - networks
  /networks/{networkId}/alerts/history:
    get:
      description: Return the alert history for this network
      operationId: getNetworkAlertsHistory
      parameters:
      - name: networkId
        in: path
        description: Network ID
        schema:
          type: string
        required: true
      - name: perPage
        in: query
        description: The number of entries per page returned. Acceptable range is 3 - 1000. Default is 100.
        schema:
          type: integer
      - name: startingAfter
        in: query
        description: A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
        schema:
          type: string
      - name: endingBefore
        in: query
        description: A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    occurredAt:
                      type: string
                      description: time when the event occurred
                    alertTypeId:
                      type: string
                      description: type of alert
                    alertType:
                      type: string
                      description: user friendly alert type
                    device:
                      type: object
                      properties:
                        serial:
                          type: string
                          description: device serial
                      description: info related to the device that caused the alert
                    destinations:
                      type: object
                      properties:
                        email:
                          type: object
                          properties:
                            sentAt:
                              type: string
                              description: time when the alert was sent to the user(s) for this channel
                          description: email destinations for this alert
                        push:
                          type: object
                          properties:
                            sentAt:
                              type: string
                              description: time when the alert was sent to the user(s) for this channel
                          description: push destinations for this alert
                        sms:
                          type: object
                          properties:
                            sentAt:
                              type: string
                              description: time when the alert was sent to the user(s) for this channel
                          description: sms destinations for this alert
                        webhook:
                          type: object
                          properties:
                            sentAt:
                              type: string
                              description: time when the alert was sent to the user(s) for this channel
                          description: webhook destinations for this alert
                      description: the destinations this alert is configured to be delivered to
                    alertData:
                      type: object
                      description: relevant data about the event that caused the alert
              example:
              - occurredAt: '2022-07-11T22:35:34Z'
                alertTypeId: settings_changed
                alertType: Settings changed
                device:
                  serial: Q3CG-G6W8-BEVR
                destinations:
                  email:
                    sentAt: '2022-07-11T22:40:34Z'
                  push:
                    sentAt: '2022-07-11T22:40:34Z'
                  sms:
                    sentAt: '2022-07-11T22:40:34Z'
                  webhook:
                    sentAt: '2022-07-11T22:40:34Z'
          headers:
            Link:
              schema:
                type: string
              description: A comma-separated list of first, last, prev, and next relative links used for subsequent paginated requests.
      security:
      - oauth2:
        - dashboard:general:telemetry:read
      summary: Return the alert history for this network
      tags:
      - networks
  /networks/{networkId}/alerts/settings:
    get:
      description: Return the alert configuration for this network
      operationId: getNetworkAlertsSettings
      parameters:
      - name: networkId
        in: path
        description: Network ID
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  defaultDestinations:
                    type: object
                    properties:
                      emails:
                        type: array
                        items:
                          type: string
                        description: A list of emails that will receive the alert(s).
                      allAdmins:
                        type: boolean
                        description: If true, then all network admins will receive emails.
                      snmp:
                        type: boolean
                        description: If true, then an SNMP trap will be sent if there is an SNMP trap server configured for this network.
                      httpServerIds:
                        type: array
                        items:
                          type: string
                        description: A list of HTTP server IDs to send a Webhook to
                    description: The network-wide destinations for all alerts on the network.
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          description: The type of alert
                        enabled:
                          type: boolean
                          description: A boolean depicting if the alert is turned on or off
                        alertDestinations:
                          type: object
                          properties:
                            emails:
                              type: array
                              items:
                                type: string
                              description: A list of emails that will receive information about the alert
                            smsNumbers:
                              type: array
                              items:
                                type: string
                              description: A list of phone numbers that will receive text messages about the alert. Only available for sensors status alerts.
                            allAdmins:
                              type: boolean
                              description: If true, then all network admins will receive emails for this alert
                            snmp:
                              type: boolean
                              description: If true, then an SNMP trap will be sent for this alert if there is an SNMP trap server configured for this network
                            httpServerIds:
                              type: array
                              items:
                                type: string
                              description: A list of HTTP server IDs to send a Webhook to for this alert
                          description: A hash of destinations for this specific alert
                        filters:
                          type: object
                          properties:
                            conditions:
                              type: array
                              items:
                                type: object
                                properties:
                                  type:
                                    type: string
                                    description: Type of condition
                                  unit:
                                    type:
                                    - string
                                    - 'null'
                                    description: Unit
                                  duration:
                                    type: integer
                                    description: Duration
                                  direction:
                                    type: string
                                    enum:
                                    - +
                                    - '-'
                                    description: Direction
                                  threshold:
                                    type: number
                                    format: float
                                    description: Threshold
                              description: Conditions
                            failureType:
                              type: string
                              description: Failure Type
                            lookbackWindow:
                              type: integer
                              description: Loopback Window (in sec)
                            minDuration:
                              type: integer
                              description: Min Duration
                            name:
                              type: string
                              description: Name
                            period:
                              type: integer
                              description: Period
                            priority:
                              type: string
                              description: Priority
                            regex:
                              type: string
                              description: Regex
                            selector:
                              type: string
                              description: Selector
                            serials:
                              type: array
                              items:
                                type: string
                              description: Serials
                            ssidNum:
                              type: integer
                              description: SSID Number
                            tag:
                              type: string
                              description: Tag
                            threshold:
                              type: integer
                              description: Threshold
                            timeout:
                              type: integer
                              description: Timeout
                          description: A hash of specific configuration data for the alert. Only filters specific to the alert will be updated.
                      required:
                      - type
                    description: Alert-specific configuration for each type. Only alerts that pertain to the network can be updated.
                  muting:
                    type: object
                    properties:
                      byPortSchedules:
                        type: object
                        properties:
                          enabled:
                            type: boolean
                            description: If true, then wireless unreachable alerts will be muted when caused by a port schedule
                        description: Mute wireless unreachable alerts based on switch port schedules
                    description: Mute alerts under certain conditions
              example:
                defaultDestinations:
                  emails:
                  - miles@meraki.com
                  allAdmins: true
                  snmp: true
                  httpServerIds:
                  - aHR0cHM6Ly93d3cuZXhhbXBsZS5jb20vd2ViaG9va3M=
                alerts:
                - type: gatewayDown
                  enabled: true
                  alertDestinations:
                    emails:
                    - miles@meraki.com
                    smsNumbers:
                    - '+15555555555'
                    allAdmins: false
                    snmp: false
                    httpServerIds:
                    - aHR0cHM6Ly93d3cuZXhhbXBsZS5jb20vd2ViaG9va3M=
                  filters:
                    conditions:
                    - type: temperature
                      unit: celsius
                      duration: 0
                      direction: +
                      threshold: 72.5
                    failureType: 802.1X auth fail
                    lookbackWindow: 360
                    minDuration: 60
                    name: Filter
                    period: 1800
                    priority: ''
                    regex: '[a-z]'
                    selector: '{"smartSensitivity":"medium","smartEnabled":false,"eventReminderPeriodSecs":10800}'
                    serials:
                    - Q234-ABCD-0001
                    - Q234-ABCD-0002
                    - Q234-ABCD-0003
                    ssidNum: 1
                    tag: tag1
                    threshold: 30
                    timeout: 60
                muting:
                  byPortSchedules:
                    enabled: true
      security:
      - oauth2:
        - dashboard:general:telemetry:read
      summary: Return the alert configuration for this network
      tags:
      - networks
    put:
      description: Update the alert configuration for this network
      operationId: updateNetworkAlertsSettings
      parameters:
      - name: networkId
        in: path
        description: Network ID
        schema:
          type: string
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                defaultDestinations:
                  type: object
                  properties:
                    emails:
                      type: array
                      items:
                        type: string
                      description: A list of emails that will receive the alert(s).
                    allAdmins:
                      type: boolean
                      description: If true, then all network admins will receive emails.
                    snmp:
                      type: boolean
                      description: If true, then an SNMP trap will be sent if there is an SNMP trap server configured for this network.
                    httpServerIds:
                      type: array
                      items:
                        type: string
                      description: A list of HTTP server IDs to send a Webhook to
                  description: The network-wide destinations for all alerts on the network.
                alerts:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        description: The type of alert
                      enabled:
                        type: boolean
                        description: A boolean depicting if the alert is turned on or off
                      alertDestinations:
                        type: object
                        properties:
                          emails:
                            type: array
                            items:
                              type: string
                            description: A list of emails that will receive information about the alert
                          smsNumbers:
                            type: array
                            items:
                              type: string
                            description: A list of phone numbers that will receive text messages about the alert. Only available for sensors status alerts.
                          allAdmins:
                            type: boolean
                            description: If true, then all network admins will receive emails for this alert
                          snmp:
                            type: boolean
                            description: If true, then an SNMP trap will be sent for this alert if there is an SNMP trap server configured for this network
                          httpServerIds:
                            type: array
                            items:
                              type: string
                            description: A list of HTTP server IDs to send a Webhook to for this alert
                        description: A hash of destinations for this specific alert
                      filters:
                        type: object
                        properties:
                          conditions:
                            type: array
                            items:
                              type: object
                              properties:
                                type:
                                  type: string
                                  description: Type of condition
                                unit:
                                  type:
                                  - string
                                  - 'null'
                                  description: Unit
                                duration:
                                  type: integer
                                  description: Duration
                                direction:
                                  type: string
                                  enum:
                                  - +
                                  - '-'
                                  description: Direction
                                threshold:
                                  type: number
                                  format: float
                                  description: Threshold
                            description: Conditions
                          failureType:
                            type: string
                            description: Failure Type
                          lookbackWindow:
                            type: integer
                            description: Loopback Window (in sec)
                          minDuration:
                            type: integer
                            description: Min Duration
                          name:
                            type: string
                            description: Name
                          period:
                            type: integer
                            description: Period
                          priority:
                            type: string
                            description: Priority
                          regex:
                            type: string
                            description: Regex
                          selector:
                            type: string
                            description: Selector
                          serials:
                            type: array
                            items:
                              type: string
                            description: Serials
                          ssidNum:
                            type: integer
                            description: SSID Number
                          tag:
                            type: string
                            description: Tag
                          threshold:
                            type: integer
                            description: Threshold
                          timeout:
                            type: integer
                            description: Timeout
                        description: A hash of specific configuration data for the alert. Only filters specific to the alert will be updated.
                    required:
                    - type
                  description: Alert-specific configuration for each type. Only alerts that pertain to the network can be updated.
                muting:
                  type: object
                  properties:
                    byPortSchedules:
                      type: object
                      properties:
                        enabled:
                          type: boolean
                          description: If true, then wireless unreachable alerts will be muted when caused by a port schedule
                      description: Mute wireless unreachable alerts based on switch port schedules
                  description: Mute alerts under certain conditions
              example:
                defaultDestinations:
                  emails:
                  - miles@meraki.com
                  allAdmins: true
                  snmp: true
                  httpServerIds:
                  - aHR0cHM6Ly93d3cuZXhhbXBsZS5jb20vd2ViaG9va3M=
                alerts:
                - type: gatewayDown
                  enabled: true
                  alertDestinations:
                    emails:
                    - miles@meraki.com
                    smsNumbers:
                    - '+15555555555'
                    allAdmins: false
                    snmp: false
                    httpServerIds:
                    - aHR0cHM6Ly93d3cuZXhhbXBsZS5jb20vd2ViaG9va3M=
                  filters:
                    conditions:
                    - type: temperature
                      unit: celsius
                      duration: 0
                      direction: +
                      threshold: 72.5
                    failureType: 802.1X auth fail
                    lookbackWindow: 360
                    minDuration: 60
                    name: Filter
                    period: 1800
                    priority: ''
                    regex: '[a-z]'
                    selector: '{"smartSensitivity":"medium","smartEnabled":false,"eventReminderPeriodSecs":10800}'
                    serials:
                    - Q234-ABCD-0001
                    - Q234-ABCD-0002
                    - Q234-ABCD-0003
                    ssidNum: 1
                    tag: tag1
                    threshold: 30
                    timeout: 60
                muting:
                  byPortSchedules:
                    enabled: true
        required: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  defaultDestinations:
                    type: object
                    properties:
                      emails:
                        type: array
                        items:
                          type: string
                        description: A list of emails that will receive the alert(s).
                      allAdmins:
                        type: boolean
                        description: If true, then all network admins will receive emails.
                      snmp:
                        type: boolean
                        description: If true, then an SNMP trap will be sent if there is an SNMP trap server configured for this network.
                      httpServerIds:
                        type: array
                        items:
                          type: string
            

# --- truncated at 32 KB (816 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-meraki/refs/heads/main/openapi/cisco-meraki-networks-api-openapi.yml