How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cisco Meraki Switch API

The switch API from Cisco Meraki — 56 operation(s) for switch.

Cisco Meraki Switch API is one of 21 APIs that Cisco Meraki publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Switch. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 102 operations across 56 paths. It is described by OpenAPI 3.2.0, at version 1.73.0.

Requests are made against a single base URL, https://api.meraki.com/{basePath}.

102 operations 56 paths 0 schemas 11 DELETE49 GET15 POST27 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.73.0
Base URL
https://developer.cisco.com/meraki/webhooks/
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Cisco Meraki Switch API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 102

Across 56 paths, the API surfaces 102 operations — 11 DELETE, 49 GET, 15 POST, 27 PUT. Each is listed below with its method, path, parameters, and response codes.

switch 102
GET
/devices/{serial}/switch/ports
List the switch ports for a switch
getDeviceSwitchPorts 1 param → 200
POST
/devices/{serial}/switch/ports/cycledeprecated
Cycle a set of switch ports on non-Catalyst MS devices
cycleDeviceSwitchPorts 1 param body → 200
GET
/devices/{serial}/switch/ports/statuses
Return the status for all the ports of a switch
getDeviceSwitchPortsStatuses 3 params → 200
GET
/devices/{serial}/switch/ports/statuses/packets
Return the packet counters for all the ports of a switch
getDeviceSwitchPortsStatusesPackets 3 params → 200
GET
/devices/{serial}/switch/ports/{portId}
Return a switch port
getDeviceSwitchPort 2 params → 200
PUT
/devices/{serial}/switch/ports/{portId}
Update a switch port
updateDeviceSwitchPort 2 params body → 200
GET
/devices/{serial}/switch/routing/interfaces
List layer 3 interfaces for a switch
getDeviceSwitchRoutingInterfaces 3 params → 200
POST
/devices/{serial}/switch/routing/interfaces
Create a layer 3 interface for a switch
createDeviceSwitchRoutingInterface 1 param body → 201
GET
/devices/{serial}/switch/routing/interfaces/{interfaceId}
Return a layer 3 interface for a switch
getDeviceSwitchRoutingInterface 2 params → 200
PUT
/devices/{serial}/switch/routing/interfaces/{interfaceId}
Update a layer 3 interface for a switch
updateDeviceSwitchRoutingInterface 2 params body → 200
DELETE
/devices/{serial}/switch/routing/interfaces/{interfaceId}
Delete a layer 3 interface from the switch
deleteDeviceSwitchRoutingInterface 2 params → 204
GET
/devices/{serial}/switch/routing/interfaces/{interfaceId}/dhcp
Return a layer 3 interface DHCP configuration for a switch
getDeviceSwitchRoutingInterfaceDhcp 2 params → 200
PUT
/devices/{serial}/switch/routing/interfaces/{interfaceId}/dhcp
Update a layer 3 interface DHCP configuration for a switch
updateDeviceSwitchRoutingInterfaceDhcp 2 params body → 200
GET
/devices/{serial}/switch/routing/staticRoutes
List layer 3 static routes for a switch
getDeviceSwitchRoutingStaticRoutes 1 param → 200
POST
/devices/{serial}/switch/routing/staticRoutes
Create a layer 3 static route for a switch
createDeviceSwitchRoutingStaticRoute 1 param body → 200
GET
/devices/{serial}/switch/routing/staticRoutes/{staticRouteId}
Return a layer 3 static route for a switch
getDeviceSwitchRoutingStaticRoute 2 params → 200
PUT
/devices/{serial}/switch/routing/staticRoutes/{staticRouteId}
Update a layer 3 static route for a switch
updateDeviceSwitchRoutingStaticRoute 2 params body → 201
DELETE
/devices/{serial}/switch/routing/staticRoutes/{staticRouteId}
Delete a layer 3 static route for a switch
deleteDeviceSwitchRoutingStaticRoute 2 params → 204
GET
/devices/{serial}/switch/warmSpare
Return warm spare configuration for a switch
getDeviceSwitchWarmSpare 1 param → 200
PUT
/devices/{serial}/switch/warmSpare
Update warm spare configuration for a switch
updateDeviceSwitchWarmSpare 1 param body → 200
GET
/networks/{networkId}/switch/accessControlLists
Return the access control lists for a MS network
getNetworkSwitchAccessControlLists 1 param → 200
PUT
/networks/{networkId}/switch/accessControlLists
Update the access control lists for a MS network
updateNetworkSwitchAccessControlLists 1 param body → 200
GET
/networks/{networkId}/switch/accessPolicies
List the access policies for a switch network
getNetworkSwitchAccessPolicies 1 param → 200
POST
/networks/{networkId}/switch/accessPolicies
Create an access policy for a switch network
createNetworkSwitchAccessPolicy 1 param body → 201
GET
/networks/{networkId}/switch/accessPolicies/{accessPolicyNumber}
Return a specific access policy for a switch network
getNetworkSwitchAccessPolicy 2 params → 200
PUT
/networks/{networkId}/switch/accessPolicies/{accessPolicyNumber}
Update an access policy for a switch network
updateNetworkSwitchAccessPolicy 2 params body → 200
DELETE
/networks/{networkId}/switch/accessPolicies/{accessPolicyNumber}
Delete an access policy for a switch network
deleteNetworkSwitchAccessPolicy 2 params → 204
GET
/networks/{networkId}/switch/alternateManagementInterface
Return the switch alternate management interface for the network
getNetworkSwitchAlternateManagementInterface 1 param → 200
PUT
/networks/{networkId}/switch/alternateManagementInterface
Update the switch alternate management interface for the network
updateNetworkSwitchAlternateManagementInterface 1 param body → 200
GET
/networks/{networkId}/switch/dhcp/v4/servers/seen
Return the network's DHCPv4 servers seen within the selected timeframe (default 1 day)
getNetworkSwitchDhcpV4ServersSeen 6 params → 200
GET
/networks/{networkId}/switch/dhcpServerPolicy
Return the DHCP server settings
getNetworkSwitchDhcpServerPolicy 1 param → 200
PUT
/networks/{networkId}/switch/dhcpServerPolicy
Update the DHCP server settings
updateNetworkSwitchDhcpServerPolicy 1 param body → 200
GET
/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers
Return the list of servers trusted by Dynamic ARP Inspection on this network
getNetworkSwitchDhcpServerPolicyArpInspectionTrustedServers 4 params → 200
POST
/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers
Add a server to be trusted by Dynamic ARP Inspection on this network
createNetworkSwitchDhcpServerPolicyArpInspectionTrustedServer 1 param body → 201
PUT
/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers/{trustedServerId}
Update a server that is trusted by Dynamic ARP Inspection on this network
updateNetworkSwitchDhcpServerPolicyArpInspectionTrustedServer 2 params body → 200
DELETE
/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers/{trustedServerId}
Remove a server from being trusted by Dynamic ARP Inspection on this network
deleteNetworkSwitchDhcpServerPolicyArpInspectionTrustedServer 2 params → 204
GET
/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/warnings/byDevice
Return the devices that have a Dynamic ARP Inspection warning and their warnings
getNetworkSwitchDhcpServerPolicyArpInspectionWarningsByDevice 4 params → 200
GET
/networks/{networkId}/switch/dscpToCosMappings
Return the DSCP to CoS mappings
getNetworkSwitchDscpToCosMappings 1 param → 200
PUT
/networks/{networkId}/switch/dscpToCosMappings
Update the DSCP to CoS mappings
updateNetworkSwitchDscpToCosMappings 1 param body → 200
GET
/networks/{networkId}/switch/linkAggregations
List link aggregation groups
getNetworkSwitchLinkAggregations 1 param → 200
POST
/networks/{networkId}/switch/linkAggregations
Create a link aggregation group
createNetworkSwitchLinkAggregation 1 param body → 201
PUT
/networks/{networkId}/switch/linkAggregations/{linkAggregationId}
Update a link aggregation group
updateNetworkSwitchLinkAggregation 2 params body → 200
DELETE
/networks/{networkId}/switch/linkAggregations/{linkAggregationId}
Split a link aggregation group into separate ports
deleteNetworkSwitchLinkAggregation 2 params → 204
GET
/networks/{networkId}/switch/mtu
Return the MTU configuration
getNetworkSwitchMtu 1 param → 200
PUT
/networks/{networkId}/switch/mtu
Update the MTU configuration
updateNetworkSwitchMtu 1 param body → 200
GET
/networks/{networkId}/switch/portSchedules
List switch port schedules
getNetworkSwitchPortSchedules 1 param → 200
POST
/networks/{networkId}/switch/portSchedules
Add a switch port schedule
createNetworkSwitchPortSchedule 1 param body → 201
DELETE
/networks/{networkId}/switch/portSchedules/{portScheduleId}
Delete a switch port schedule
deleteNetworkSwitchPortSchedule 2 params → 204
PUT
/networks/{networkId}/switch/portSchedules/{portScheduleId}
Update a switch port schedule
updateNetworkSwitchPortSchedule 2 params body → 200
GET
/networks/{networkId}/switch/qosRules
List quality of service rules
getNetworkSwitchQosRules 1 param → 200
POST
/networks/{networkId}/switch/qosRules
Add a quality of service rule
createNetworkSwitchQosRule 1 param body → 201
GET
/networks/{networkId}/switch/qosRules/order
Return the quality of service rule IDs by order in which they will be processed by the switch
getNetworkSwitchQosRulesOrder 1 param → 200
PUT
/networks/{networkId}/switch/qosRules/order
Update the order in which the rules should be processed by the switch
updateNetworkSwitchQosRulesOrder 1 param body → 200
GET
/networks/{networkId}/switch/qosRules/{qosRuleId}
Return a quality of service rule
getNetworkSwitchQosRule 2 params → 200
DELETE
/networks/{networkId}/switch/qosRules/{qosRuleId}
Delete a quality of service rule
deleteNetworkSwitchQosRule 2 params → 204
PUT
/networks/{networkId}/switch/qosRules/{qosRuleId}
Update a quality of service rule
updateNetworkSwitchQosRule 2 params body → 200
GET
/networks/{networkId}/switch/routing/multicast
Return multicast settings for a network
getNetworkSwitchRoutingMulticast 1 param → 200
PUT
/networks/{networkId}/switch/routing/multicast
Update multicast settings for a network
updateNetworkSwitchRoutingMulticast 1 param body → 200
GET
/networks/{networkId}/switch/routing/multicast/rendezvousPoints
List multicast rendezvous points
getNetworkSwitchRoutingMulticastRendezvousPoints 1 param → 200
POST
/networks/{networkId}/switch/routing/multicast/rendezvousPoints
Create a multicast rendezvous point
createNetworkSwitchRoutingMulticastRendezvousPoint 1 param body → 201
GET
/networks/{networkId}/switch/routing/multicast/rendezvousPoints/{rendezvousPointId}
Return a multicast rendezvous point
getNetworkSwitchRoutingMulticastRendezvousPoint 2 params → 200
DELETE
/networks/{networkId}/switch/routing/multicast/rendezvousPoints/{rendezvousPointId}
Delete a multicast rendezvous point
deleteNetworkSwitchRoutingMulticastRendezvousPoint 2 params → 204
PUT
/networks/{networkId}/switch/routing/multicast/rendezvousPoints/{rendezvousPointId}
Update a multicast rendezvous point
updateNetworkSwitchRoutingMulticastRendezvousPoint 2 params body → 200
GET
/networks/{networkId}/switch/routing/ospf
Return layer 3 OSPF routing configuration
getNetworkSwitchRoutingOspf 2 params → 200
PUT
/networks/{networkId}/switch/routing/ospf
Update layer 3 OSPF routing configuration
updateNetworkSwitchRoutingOspf 2 params body → 200
GET
/networks/{networkId}/switch/settings
Returns the switch network settings
getNetworkSwitchSettings 1 param → 200
PUT
/networks/{networkId}/switch/settings
Update switch network settings
updateNetworkSwitchSettings 1 param body → 200
GET
/networks/{networkId}/switch/stacks
List the switch stacks in a network
getNetworkSwitchStacks 1 param → 200
POST
/networks/{networkId}/switch/stacks
Create a switch stack
createNetworkSwitchStack 1 param body → 200
PUT
/networks/{networkId}/switch/stacks/{switchStackId}
Update a switch stack
updateNetworkSwitchStack 2 params body → 200
GET
/networks/{networkId}/switch/stacks/{switchStackId}
Show a switch stack
getNetworkSwitchStack 2 params → 200
DELETE
/networks/{networkId}/switch/stacks/{switchStackId}
Delete a stack
deleteNetworkSwitchStack 2 params → 204
POST
/networks/{networkId}/switch/stacks/{switchStackId}/add
Add a switch to a stack
addNetworkSwitchStack 2 params body → 200
POST
/networks/{networkId}/switch/stacks/{switchStackId}/remove
Remove a switch from a stack
removeNetworkSwitchStack 2 params body → 200
GET
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces
List layer 3 interfaces for a switch stack
getNetworkSwitchStackRoutingInterfaces 4 params → 200
POST
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces
Create a layer 3 interface for a switch stack
createNetworkSwitchStackRoutingInterface 2 params body → 201
GET
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}
Return a layer 3 interface from a switch stack
getNetworkSwitchStackRoutingInterface 3 params → 200
PUT
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}
Update a layer 3 interface for a switch stack
updateNetworkSwitchStackRoutingInterface 3 params body → 200
DELETE
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}
Delete a layer 3 interface from a switch stack
deleteNetworkSwitchStackRoutingInterface 3 params → 204
GET
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}/dhcp
Return a layer 3 interface DHCP configuration for a switch stack
getNetworkSwitchStackRoutingInterfaceDhcp 3 params → 200
PUT
/networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}/dhcp
Update a layer 3 interface DHCP configuration for a switch stack
updateNetworkSwitchStackRoutingInterfaceDhcp 3 params body → 200
GET
/networks/{networkId}/switch/stacks/{switchStackId}/routing/staticRoutes
List layer 3 static routes for a switch stack
getNetworkSwitchStackRoutingStaticRoutes 2 params → 200
POST
/networks/{networkId}/switch/stacks/{switchStackId}/routing/staticRoutes
Create a layer 3 static route for a switch stack
createNetworkSwitchStackRoutingStaticRoute 2 params body → 201
GET
/networks/{networkId}/switch/stacks/{switchStackId}/routing/staticRoutes/{staticRouteId}
Return a layer 3 static route for a switch stack
getNetworkSwitchStackRoutingStaticRoute 3 params → 200
PUT
/networks/{networkId}/switch/stacks/{switchStackId}/routing/staticRoutes/{staticRouteId}
Update a layer 3 static route for a switch stack
updateNetworkSwitchStackRoutingStaticRoute 3 params body → 200
DELETE
/networks/{networkId}/switch/stacks/{switchStackId}/routing/staticRoutes/{staticRouteId}
Delete a layer 3 static route for a switch stack
deleteNetworkSwitchStackRoutingStaticRoute 3 params → 204
GET
/networks/{networkId}/switch/stormControl
Return the storm control configuration for a switch network
getNetworkSwitchStormControl 1 param → 200
PUT
/networks/{networkId}/switch/stormControl
Update the storm control configuration for a switch network
updateNetworkSwitchStormControl 1 param body → 200
GET
/networks/{networkId}/switch/stp
Returns STP settings
getNetworkSwitchStp 1 param → 200
PUT
/networks/{networkId}/switch/stp
Updates STP settings
updateNetworkSwitchStp 1 param body → 200
GET
/organizations/{organizationId}/configTemplates/{configTemplateId}/switch/profiles
List the switch templates for your switch template configuration
getOrganizationConfigTemplateSwitchProfiles 2 params → 200
GET
/organizations/{organizationId}/configTemplates/{configTemplateId}/switch/profiles/{profileId}/ports
Return all the ports of a switch template
getOrganizationConfigTemplateSwitchProfilePorts 3 params → 200
GET
/organizations/{organizationId}/configTemplates/{configTemplateId}/switch/profiles/{profileId}/ports/{portId}
Return a switch template port
getOrganizationConfigTemplateSwitchProfilePort 4 params → 200
PUT
/organizations/{organizationId}/configTemplates/{configTemplateId}/switch/profiles/{profileId}/ports/{portId}
Update a switch template port
updateOrganizationConfigTemplateSwitchProfilePort 4 params body → 200
GET
/organizations/{organizationId}/summary/switch/power/history
Returns the total PoE power draw for all switch ports in the organization over the requested timespan (by default the last 24 hours)
getOrganizationSummarySwitchPowerHistory 4 params → 200
POST
/organizations/{organizationId}/switch/devices/clone
Clone port-level and some switch-level configuration settings from a source switch to one or more target switches
cloneOrganizationSwitchDevices 1 param body → 200
GET
/organizations/{organizationId}/switch/ports/bySwitch
List the switchports in an organization by switch
getOrganizationSwitchPortsBySwitch 12 params → 200
GET
/organizations/{organizationId}/switch/ports/clients/overview/byDevice
List the number of clients for all switchports with at least one online client in an organization.
getOrganizationSwitchPortsClientsOverviewByDevice 14 params → 200
GET
/organizations/{organizationId}/switch/ports/overview
Returns the counts of all active ports for the requested timespan, grouped by speed
getOrganizationSwitchPortsOverview 4 params → 200
GET
/organizations/{organizationId}/switch/ports/statuses/bySwitch
List the switchports in an organization
getOrganizationSwitchPortsStatusesBySwitch 12 params → 200
GET
/organizations/{organizationId}/switch/ports/topology/discovery/byDevice
List most recently seen LLDP/CDP discovery and topology information per switch port in an organization.
getOrganizationSwitchPortsTopologyDiscoveryByDevice 14 params → 200
GET
/organizations/{organizationId}/switch/ports/usage/history/byDevice/byInterval
List the historical usage and traffic data of switchports in an organization.
getOrganizationSwitchPortsUsageHistoryByDeviceByInterval 16 params → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cisco-meraki-switch-api-openapi.yml Raw ↑

Other APIs Cisco Meraki publishes across the network.

Meraki Webhooks
Cisco Meraki Administered API
Cisco Meraki Appliance API
Cisco Meraki Camera API
Cisco Meraki Campus Gateway API
Cisco Meraki Cellular Gateway API
Cisco Meraki Devices API
Cisco Meraki Insight API
Cisco Meraki Licensing API
Cisco Meraki Networks API
Cisco Meraki Organizations API
Cisco Meraki Sensor API
Where this information came from

This is an independent, third-party profile of Cisco Meraki Switch API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.