# Cisco Hardware Switch API

**Canonical:** https://apis.io/apis/cisco-hardware/cisco-hardware-switch-api/  
**Provider:** Cisco Hardware — https://apis.io/providers/cisco-hardware/  
**Base URL:** https://api.meraki.com/api/v1  
**Documentation:** https://developer.cisco.com/docs/dna-center/

Cisco Hardware Switch API is one of 20 APIs that [Cisco Hardware](https://apis.io/providers/cisco-hardware/) publishes on the [APIs.io](https://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, and a getting-started guide.

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

## Operations (60 of 102)

| Method | Path | Summary |
|---|---|---|
| GET | `/devices/{serial}/switch/ports` | List the switch ports for a switch |
| POST | `/devices/{serial}/switch/ports/cycle` | Cycle a set of switch ports on non-Catalyst MS devices |
| GET | `/devices/{serial}/switch/ports/statuses` | Return the status for all the ports of a switch |
| GET | `/devices/{serial}/switch/ports/statuses/packets` | Return the packet counters for all the ports of a switch |
| GET | `/devices/{serial}/switch/ports/{portId}` | Return a switch port |
| PUT | `/devices/{serial}/switch/ports/{portId}` | Update a switch port |
| GET | `/devices/{serial}/switch/routing/interfaces` | List layer 3 interfaces for a switch |
| POST | `/devices/{serial}/switch/routing/interfaces` | Create a layer 3 interface for a switch |
| GET | `/devices/{serial}/switch/routing/interfaces/{interfaceId}` | Return a layer 3 interface for a switch |
| PUT | `/devices/{serial}/switch/routing/interfaces/{interfaceId}` | Update a layer 3 interface for a switch |
| DELETE | `/devices/{serial}/switch/routing/interfaces/{interfaceId}` | Delete a layer 3 interface from the switch |
| GET | `/devices/{serial}/switch/routing/interfaces/{interfaceId}/dhcp` | Return a layer 3 interface DHCP configuration for a switch |
| PUT | `/devices/{serial}/switch/routing/interfaces/{interfaceId}/dhcp` | Update a layer 3 interface DHCP configuration for a switch |
| GET | `/devices/{serial}/switch/routing/staticRoutes` | List layer 3 static routes for a switch |
| POST | `/devices/{serial}/switch/routing/staticRoutes` | Create a layer 3 static route for a switch |
| GET | `/devices/{serial}/switch/routing/staticRoutes/{staticRouteId}` | Return a layer 3 static route for a switch |
| PUT | `/devices/{serial}/switch/routing/staticRoutes/{staticRouteId}` | Update a layer 3 static route for a switch |
| DELETE | `/devices/{serial}/switch/routing/staticRoutes/{staticRouteId}` | Delete a layer 3 static route for a switch |
| GET | `/devices/{serial}/switch/warmSpare` | Return warm spare configuration for a switch |
| PUT | `/devices/{serial}/switch/warmSpare` | Update warm spare configuration for a switch |
| GET | `/networks/{networkId}/switch/accessControlLists` | Return the access control lists for a MS network |
| PUT | `/networks/{networkId}/switch/accessControlLists` | Update the access control lists for a MS network |
| GET | `/networks/{networkId}/switch/accessPolicies` | List the access policies for a switch network |
| POST | `/networks/{networkId}/switch/accessPolicies` | Create an access policy for a switch network |
| GET | `/networks/{networkId}/switch/accessPolicies/{accessPolicyNumber}` | Return a specific access policy for a switch network |
| PUT | `/networks/{networkId}/switch/accessPolicies/{accessPolicyNumber}` | Update an access policy for a switch network |
| DELETE | `/networks/{networkId}/switch/accessPolicies/{accessPolicyNumber}` | Delete an access policy for a switch network |
| GET | `/networks/{networkId}/switch/alternateManagementInterface` | Return the switch alternate management interface for the network |
| PUT | `/networks/{networkId}/switch/alternateManagementInterface` | Update the switch alternate management interface for the network |
| GET | `/networks/{networkId}/switch/dhcp/v4/servers/seen` | Return the network's DHCPv4 servers seen within the selected timeframe (default… |
| GET | `/networks/{networkId}/switch/dhcpServerPolicy` | Return the DHCP server settings |
| PUT | `/networks/{networkId}/switch/dhcpServerPolicy` | Update the DHCP server settings |
| GET | `/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers` | Return the list of servers trusted by Dynamic ARP Inspection on this network |
| POST | `/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers` | Add a server to be trusted by Dynamic ARP Inspection on this network |
| PUT | `/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers/{trustedServerId}` | Update a server that is trusted by Dynamic ARP Inspection on this network |
| DELETE | `/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/trustedServers/{trustedServerId}` | Remove a server from being trusted by Dynamic ARP Inspection on this network |
| GET | `/networks/{networkId}/switch/dhcpServerPolicy/arpInspection/warnings/byDevice` | Return the devices that have a Dynamic ARP Inspection warning and their warnings |
| GET | `/networks/{networkId}/switch/dscpToCosMappings` | Return the DSCP to CoS mappings |
| PUT | `/networks/{networkId}/switch/dscpToCosMappings` | Update the DSCP to CoS mappings |
| GET | `/networks/{networkId}/switch/linkAggregations` | List link aggregation groups |
| POST | `/networks/{networkId}/switch/linkAggregations` | Create a link aggregation group |
| PUT | `/networks/{networkId}/switch/linkAggregations/{linkAggregationId}` | Update a link aggregation group |
| DELETE | `/networks/{networkId}/switch/linkAggregations/{linkAggregationId}` | Split a link aggregation group into separate ports |
| GET | `/networks/{networkId}/switch/mtu` | Return the MTU configuration |
| PUT | `/networks/{networkId}/switch/mtu` | Update the MTU configuration |
| GET | `/networks/{networkId}/switch/portSchedules` | List switch port schedules |
| POST | `/networks/{networkId}/switch/portSchedules` | Add a switch port schedule |
| DELETE | `/networks/{networkId}/switch/portSchedules/{portScheduleId}` | Delete a switch port schedule |
| PUT | `/networks/{networkId}/switch/portSchedules/{portScheduleId}` | Update a switch port schedule |
| GET | `/networks/{networkId}/switch/qosRules` | List quality of service rules |
| POST | `/networks/{networkId}/switch/qosRules` | Add a quality of service rule |
| GET | `/networks/{networkId}/switch/qosRules/order` | Return the quality of service rule IDs by order in which they will be processed… |
| PUT | `/networks/{networkId}/switch/qosRules/order` | Update the order in which the rules should be processed by the switch |
| GET | `/networks/{networkId}/switch/qosRules/{qosRuleId}` | Return a quality of service rule |
| DELETE | `/networks/{networkId}/switch/qosRules/{qosRuleId}` | Delete a quality of service rule |
| PUT | `/networks/{networkId}/switch/qosRules/{qosRuleId}` | Update a quality of service rule |
| GET | `/networks/{networkId}/switch/routing/multicast` | Return multicast settings for a network |
| PUT | `/networks/{networkId}/switch/routing/multicast` | Update multicast settings for a network |
| GET | `/networks/{networkId}/switch/routing/multicast/rendezvousPoints` | List multicast rendezvous points |
| POST | `/networks/{networkId}/switch/routing/multicast/rendezvousPoints` | Create a multicast rendezvous point |

…and 42 more operations. They are listed in full on the page.

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cisco-hardware/refs/heads/main/openapi/cisco-hardware-switch-api-openapi.yml
- **Documentation** — https://developer.cisco.com/meraki/api-latest/
- **GettingStarted** — https://developer.cisco.com/meraki/api/getting-started/
- **Documentation** — https://intersight.com/apidocs/introduction/overview/
- **SDKs** — https://github.com/CiscoDevNet/intersight-python

## Other Cisco Hardware APIs (12)

- [Cisco Catalyst Center API](https://apis.io/apis/cisco-hardware/catalyst-center-api/)
- [Cisco IOS XE RESTCONF API](https://apis.io/apis/cisco-hardware/ios-xe-restconf-api/)
- [Cisco APIC REST API](https://apis.io/apis/cisco-hardware/apic-rest-api/)
- [Cisco UCS Manager API](https://apis.io/apis/cisco-hardware/ucs-manager-api/)
- [Cisco Hardware Devices API](https://apis.io/apis/cisco-hardware/cisco-hardware-devices-api/)
- [Cisco Hardware Administered API](https://apis.io/apis/cisco-hardware/cisco-hardware-administered-api/)
- [Cisco Hardware Appliance API](https://apis.io/apis/cisco-hardware/cisco-hardware-appliance-api/)
- [Cisco Hardware Camera API](https://apis.io/apis/cisco-hardware/cisco-hardware-camera-api/)
- [Cisco Hardware Campus Gateway API](https://apis.io/apis/cisco-hardware/cisco-hardware-campusgateway-api/)
- [Cisco Hardware Cellular Gateway API](https://apis.io/apis/cisco-hardware/cisco-hardware-cellulargateway-api/)
- [Cisco Hardware Insight API](https://apis.io/apis/cisco-hardware/cisco-hardware-insight-api/)
- [Cisco Hardware Licensing API](https://apis.io/apis/cisco-hardware/cisco-hardware-licensing-api/)

## Tags

Switch

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cisco-hardware/cisco-hardware-switch-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cisco-hardware/.