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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Cisco Catalyst SD-WAN

Cisco Catalyst SD-WAN Configuration - Device Inventory API

The Configuration - Device Inventory API from Cisco Catalyst SD-WAN — 32 operation(s) for configuration - device inventory.

Documentation Provider Profile APIs.io OpenAPI GitHub

Cisco Catalyst SD-WAN Configuration - Device Inventory API is one of 382 APIs that Cisco Catalyst SD-WAN publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Configuration - Device Inventory. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 33 operations across 32 paths. It is described by OpenAPI 3.2.0, at version 26.1.0+2026-01-06.

Requests are made against a single base URL, /dataservice.

33 operations 32 paths 0 schemas 2 DELETE16 GET10 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
26.1.0+2026-01-06
Base URL
https://{sdwan-manager-host}:8443/dataservice
Contact
vmanage@cisco.com
License
Commercial License
Resource Areas
1

Paths & Operations 33

Across 32 paths, the API surfaces 33 operations — 2 DELETE, 16 GET, 10 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Configuration - Device Inventory 33
POST
/system/device
Create new device Note: In a multitenant vManage system, this API is only available in the Provider view 123.
createDevice body → 200400403500
GET
/system/device/bootstrap/device/{uuid}
Create vEdge device config
generateBootstrapConfigForVedge 5 params → 200400403500
POST
/system/device/bootstrap/devices
Create bootstrap config for software vEdges
generateBootstrapConfigForVedges body → 200400403500
GET
/system/device/bootstrap/download/{id}
Download vEdge device config
getBootstrapConfigZip 1 param → 200400403500
GET
/system/device/bootstrap/generic/devices
Create bootstrap config for software vEdges
generateGenericBootstrapConfigForVedges 2 params → 200400403500
POST
/system/device/claimDevices
Claim the selected unclaimed devices
claimDevices body → 200400403500
GET
/system/device/controllers/vedge/status
Get controllers vEdge sync status
getControllerVEdgeSyncStatus_ConfigurationDeviceInventory_3903 → 200400403500
PUT
/system/device/decommission/{uuid}
Decomission vEdge device
decommissionVedgeCloud 1 param → 200400403500
GET
/system/device/devicesWithoutSubjectSudi
retrieve devices without subject sudi
devicesWithoutSubjectSudi → 200400403500
POST
/system/device/fileupload
Upload file to vEdge
formPost body → 200400403500
POST
/system/device/generate-payg
Authenticate vSmart user account
validateUser body → 200400403500
POST
/system/device/lifecycle/management/{uuid}
Set device lifecycle needed flag
setLifeCycle 2 params → 200400403500
GET
/system/device/management/systemip
Get management system IP mapping
getManagementSystemIPInfo_ConfigurationDeviceInventory_3403 → 200400403500
PUT
/system/device/migrateDevice/{uuid}
Migrate device software to vedge/cedge
migrateDevice 1 param → 200400403500
POST
/system/device/quickconnect/smartaccount/sync
Sync devices from Smart-Account
getSmartAccountDevices body → 200400403500
PUT
/system/device/reset/{uuid}
Reset vEdge device
resetVedgeCloud 1 param → 200400403500
GET
/system/device/rma/candidates/{deviceType}
Get RMA candidates by device type
getRMACandidates 2 params → 200400403500
GET
/system/device/rootcertchain/status
Get controllers vEdge sync status
getRootCertStatusAll 1 param → 200400403500
GET
/system/device/selfsignedcert/iscreated
Whether self signed certificate created
checkSelfSignedCert_ConfigurationDeviceInventory_3903 → 200400403500
POST
/system/device/smartaccount/authenticate
Authenticate vSmart user account
smartAccountAuthenticate body → 200400403500
POST
/system/device/smartaccount/sync
Sync devices from Smart-Account
syncDevices body → 200400403500
GET
/system/device/sync/rootcertchain
Sync root certificate
syncRootCertChain → 200400403500
GET
/system/device/tenant/management/systemip
Get management system IP Note: In a multitenant vManage system, this API is only available in the Provider view.
getTenantManagementSystemIPs → 200400403500
GET
/system/device/type/{deviceCategory}deprecated
Get devices details
getCloudDockDataBasedOnDeviceType 1 param → 200400403500
GET
/system/device/type/{deviceCategory}/defaultConfigdeprecated
Get devices default config
getCloudDockDefaultConfigBasedOnDeviceType 1 param → 200400403500
GET
/system/device/unclaimedDevices
Get list of all unclaimed devices
getAllUnclaimedDevices → 200400403500
PUT
/system/device/updateDeviceSubjectSUDI/{uuid}
update subject sudi value of given device uuid
updateDeviceSubjectSUDI 1 param → 200400403500
GET
/system/device/vedgedetection
Check for Vedge Device Presence
checkvEdgeDevicePresence → 200400403500
DELETE
/system/device/vmanagerootca/{uuid}
Invalidate vManage root CA
invalidateVmanageRootCA 1 param → 200400403500
GET
/system/device/{deviceCategory}
Get devices details. When {deviceCategory = controllers}, it returns vEdge sync status, vBond, vManage and vSmart. When {deviceCategory = vedges}, it returns all available vEdge routers
getDevicesDetails 10 params → 200400403500
PUT
/system/device/{uuid}
Edit device
editDevice 1 param body → 200400403500
DELETE
/system/device/{uuid}
Delete vEdges
deleteDevice_ConfigurationDeviceInventory_2106 1 param → 200400403500
POST
/system/device/{uuid}/unlock
Unlock device
unlockDevice 1 param body → 200400403500

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cisco-catalyst-sdwan-configuration-device-inventory-api-openapi.yml Raw ↑

Other APIs Cisco Catalyst SD-WAN publishes across the network.

Cisco Catalyst SD-WAN Administration - Audit Log API
AE Profile APIs.io
Cisco Catalyst SD-WAN Administration - User and Group API
AE Profile APIs.io
Cisco Catalyst SD-WAN CCI Authorization Service - CCI Registration API
AE Profile APIs.io
Cisco Catalyst SD-WAN CCI Authorization Service - CCI Token API
AE Profile APIs.io
Cisco Catalyst SD-WAN Certificate Management - Device API
AE Profile APIs.io
Cisco Catalyst SD-WAN Certificate Management - vManage API
AE Profile APIs.io
Cisco Catalyst SD-WAN Cisco Software API
AE Profile APIs.io
Cisco Catalyst SD-WAN Client - Security API
AE Profile APIs.io
Cisco Catalyst SD-WAN Client - UI API
AE Profile APIs.io
Cisco Catalyst SD-WAN Cloud Sourced Application Compliance API
AE Profile APIs.io
Cisco Catalyst SD-WAN Cloud Sourced Application Maintenance API
AE Profile APIs.io
Cisco Catalyst SD-WAN Cluster Management API
AE Profile APIs.io
#Configuration - Device Inventory
← Back to C APIs
API Details
ID
cisco-catalyst-sdwan:cisco-catalyst-sdwan-configuration-device-inventory-api
Base URL
https://{sdwan-manager-host}:8443/dataservice
Docs
https://developer.cisco.com/docs/sdwan/administration-and-setting/
Provider
Cisco Catalyst SD-WAN
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=cisco-catalyst-sdwan-configuration-device-inventory-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/cisco-catalyst-sdwan-configuration-device-inventory-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Cisco Catalyst SD-WAN Configuration - Device Inventory 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.