# Cisco Hardware Networks API

**Canonical:** https://apis.io/apis/cisco-hardware/cisco-hardware-networks-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 Networks 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 Networks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

The networks API from Cisco Hardware — 75 operation(s) for networks.

## Operations (60 of 115)

| Method | Path | Summary |
|---|---|---|
| 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… |
| 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… |
| 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. |
| 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… |
| 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 |

…and 55 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-networks-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

Networks

---

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