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.

Business capability
Network Inventory Management BC-2600.40

Operations 33

POST /system/device #
GET /system/device/bootstrap/device/{uuid} #
POST /system/device/bootstrap/devices #
GET /system/device/bootstrap/download/{id} #
GET /system/device/bootstrap/generic/devices #
POST /system/device/claimDevices #
GET /system/device/controllers/vedge/status #
PUT /system/device/decommission/{uuid} #
GET /system/device/devicesWithoutSubjectSudi #
POST /system/device/fileupload #
POST /system/device/generate-payg #
POST /system/device/lifecycle/management/{uuid} #
GET /system/device/management/systemip #
PUT /system/device/migrateDevice/{uuid} #
POST /system/device/quickconnect/smartaccount/sync #
PUT /system/device/reset/{uuid} #
GET /system/device/rma/candidates/{deviceType} #
GET /system/device/rootcertchain/status #
GET /system/device/selfsignedcert/iscreated #
POST /system/device/smartaccount/authenticate #
POST /system/device/smartaccount/sync #
GET /system/device/sync/rootcertchain #
GET /system/device/tenant/management/systemip #
GET /system/device/type/{deviceCategory} #
GET /system/device/type/{deviceCategory}/defaultConfig #
GET /system/device/unclaimedDevices #
PUT /system/device/updateDeviceSubjectSUDI/{uuid} #
GET /system/device/vedgedetection #
DELETE /system/device/vmanagerootca/{uuid} #
GET /system/device/{deviceCategory} #
PUT /system/device/{uuid} #
DELETE /system/device/{uuid} #
POST /system/device/{uuid}/unlock #

Documentation

📖
Documentation
https://developer.cisco.com/docs/sdwan/administration-and-setting/
📖
APIReference
https://developer.cisco.com/docs/sdwan/administration-and-setting/
📖
Documentation
https://developer.cisco.com/docs/sdwan/ux-1-0-configuration/
📖
APIReference
https://developer.cisco.com/docs/sdwan/ux-1-0-configuration/
📖
Documentation
https://developer.cisco.com/docs/sdwan/ux-2-0-configuration/
📖
APIReference
https://developer.cisco.com/docs/sdwan/ux-2-0-configuration/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-system/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-system/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-transport/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-transport/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-service/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-wan-service/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-others/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-others/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-routing/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-sd-routing/
📖
Documentation
https://developer.cisco.com/docs/sdwan/feature-profiles-mobility-and-nfv/
📖
APIReference
https://developer.cisco.com/docs/sdwan/feature-profiles-mobility-and-nfv/
📖
Documentation
https://developer.cisco.com/docs/sdwan/monitoring-and-troubleshooting/
📖
APIReference
https://developer.cisco.com/docs/sdwan/monitoring-and-troubleshooting/
📖
Documentation
https://developer.cisco.com/docs/sdwan/sd-wan-services/
📖
APIReference
https://developer.cisco.com/docs/sdwan/sd-wan-services/
📖
Documentation
https://developer.cisco.com/docs/sdwan/partner-integrations/
📖
APIReference
https://developer.cisco.com/docs/sdwan/partner-integrations/
📖
Documentation
https://developer.cisco.com/docs/sdwan/others/
📖
APIReference
https://developer.cisco.com/docs/sdwan/others/

Specifications

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-catalyst-sdwan-configuration-device-inventory-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-catalyst-sdwan-configuration-device-inventory-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Others Configuration - Device Inventory API
  description: 'Other APIs

    Include APIs that do not belong to other categories'
  contact:
    email: vmanage@cisco.com
  license:
    name: Commercial License
    url: https://www.cisco.com/c/en/us/solutions/enterprise-networks/sd-wan/index.html
  version: 26.1.0+2026-01-06
  x-provenance:
    method: harvested
    authored_by: Cisco Catalyst SD-WAN
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    source_host: pubhub.devnetcloud.com
    note: 4,138 operations across 2,841 paths, published by Cisco as self-contained per-operation OpenAPI 3.1.0 fragments on the DevNet CDN and consolidated here into 13 documents. Ownership verified from info.contact vmanage@cisco.com and the Cisco license URL rather than from the fetch host.
  x-evidence:
  - type: source
    url: https://pubhub.devnetcloud.com/media/cisco-catalyst-sd-wan-26-1-api-guide/docs/
  - type: source
    url: https://developer.cisco.com/docs/sdwan/
servers:
- url: /dataservice
tags:
- name: Configuration - Device Inventory
paths:
  /system/device:
    post:
      tags:
      - Configuration - Device Inventory
      description: 'Create new device<br><br><br>Note: In a multitenant vManage system, this API is only available in the Provider view 123.'
      operationId: createDevice
      requestBody:
        description: Create device request
        content:
          application/json:
            schema:
              type: object
            examples:
              Create device request:
                description: Create device request
                value:
                  deviceIP: 1.1.1.1
                  username: cisco
                  password: cisco
                  personality: vbond
                  generateCSR: true
                  genCsrParams:
                    schedule: true
                    scheduleAt: 1729495932
                    autoRenew: false
                    keyLength: '2048'
                    resetRSA: true
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiRequestExampleSystemdevicegencsrparams'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example Value:
                  description: Example Value
                  value:
                    uuid: 2250234c-5305-41f7-a0fe-b52fcbd92833
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleDeviceaddresponse'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/bootstrap/device/{uuid}:
    get:
      tags:
      - Configuration - Device Inventory
      description: Create vEdge device config
      operationId: generateBootstrapConfigForVedge
      parameters:
      - name: uuid
        in: path
        description: Device UUID
        required: true
        schema:
          type: string
        example: ESR-6300-LIC-K9-FAUSTEST126
      - name: configtype
        in: query
        description: configtype
        required: true
        schema:
          type: string
        example: cloudinit
      - name: inclDefRootCert
        in: query
        required: true
        schema:
          type: boolean
          default: true
      - name: version
        in: query
        schema:
          type: string
          default: v1
      - name: wanif
        in: query
        description: wanif
        schema:
          type: string
        example: GigabitEthernet1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  bootstrapConfig:
                    type: string
                    example: '#cloud-config\nvinitparam:\n - uuid : ESR-6300-LIC-K9-FAUSTEST126\n - vbond : 10.0.12.26\n - org : vIPtela Inc Regression\n'
                $$ref: '#/components/schemas/GenerateBootstrapConfigForVedge'
              examples:
                Device bootstrap configuration:
                  description: Device bootstrap configuration
                  value:
                    bootstrapConfig: '#cloud-config\ninitparam:\n - uuid : ESR-6300-LIC-K9-FAUSTEST126\n - vbond : 10.0.12.26\n - org : vIPtela Inc Regression\n'
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleGetbootstrapdevice'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/bootstrap/devices:
    post:
      tags:
      - Configuration - Device Inventory
      description: Create bootstrap config for software vEdges
      operationId: generateBootstrapConfigForVedges
      requestBody:
        description: Request body for Device bootstrap configuration
        content:
          application/json:
            schema:
              type: object
              properties:
                bootstrapConfigType:
                  type: string
                uuid:
                  type: array
                  items:
                    type: string
              $$ref: '#/components/schemas/VEdgeBootstrapConfig'
            examples:
              Example Value:
                description: Example Value
                value:
                  bootstrapConfig: '#cloud-config\ninitparam:\n - uuid : ESR-6300-LIC-K9-FAUSTEST126\n - vbond : 10.0.12.26\n - org : vIPtela Inc Regression\n'
                $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiRequestExamplePostbootstrapdevices'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: b1af2563-cfa0-4ebb-989b-4d5e87f92d45
                $$ref: '#/components/schemas/GenerateBootstrapConfigForVedgesResponse'
              examples:
                Device bootstrap configuration:
                  description: Device bootstrap configuration
                  value:
                    id: b1af2563-cfa0-4ebb-989b-4d5e87f92d45
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExamplePostbootstrapdevicesresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/bootstrap/download/{id}:
    get:
      tags:
      - Configuration - Device Inventory
      description: Download vEdge device config
      operationId: getBootstrapConfigZip
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: string
        example: b4d93025-cf37-41a5-a2a6-d9113ede034c
      responses:
        '200':
          description: Success
          content:
            application/octet-stream:
              schema:
                type: object
                properties:
                  file:
                    type: string
                    example: binary
                $$ref: '#/components/schemas/GetBootstrapConfigZip'
              examples:
                Device bootstrap configuration:
                  description: Device bootstrap configuration
                  value:
                    file: binary
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleBootstrapdownloadid'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/bootstrap/generic/devices:
    get:
      tags:
      - Configuration - Device Inventory
      description: Create bootstrap config for software vEdges
      operationId: generateGenericBootstrapConfigForVedges
      parameters:
      - name: wanif
        in: query
        description: Device WAN interface
        schema:
          type: string
        example: GigabitEthernet1
      - name: sdRoutingDevice
        in: query
        description: Flag indicating if this is SD-Routing device
        schema:
          type: boolean
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: b4d93025-cf37-41a5-a2a6-d9113ede034c
                $$ref: '#/components/schemas/GenerateGenericBootstrapConfigForVedges'
              examples:
                Task Id:
                  description: Task Id
                  value:
                    id: 236c21b2-4f1d-4961-82a9-9ac05df1c1c1
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleBootstrapgenericdevices'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/claimDevices:
    post:
      tags:
      - Configuration - Device Inventory
      description: Claim the selected unclaimed devices
      operationId: claimDevices
      requestBody:
        description: Claim device request
        content:
          application/json:
            schema:
              type: object
              properties:
                chassis_list:
                  type: array
                  items:
                    type: object
                    properties:
                      chassis-serial-number:
                        type: string
                        example: SSI130300YK
                      configuredAaaUser:
                        type: array
                        items:
                          type: string
                      device-model:
                        type: string
                        example: C8000v
                      device-os:
                        type: string
                        example: next
                      device-type:
                        type: string
                        example: vedge
                      deviceId:
                        type: string
                        example: C8K-cfb84064-12e9-4f7c-b9d9-bf78ce4dfb5f
                      devicesAttached:
                        type: integer
                        format: int32
                        example: 0
                      discoveredDeviceInterfaces:
                        type: array
                        items:
                          type: string
                      host-name:
                        type: string
                        example: vm5
                      loopback:
                        type: array
                        items:
                          type: object
                          properties:
                            interfaceIP:
                              type: string
                              example: 127.0.0.1
                            interfaceName:
                              type: string
                              example: Loopback0
                          $$ref: '#/components/schemas/Loopback'
                      personality:
                        type: string
                        example: vedge
                      platform:
                        type: string
                        example: x86_64
                      reachability:
                        type: string
                        example: reachable
                        enum:
                        - reachable
                        - unreachable
                      registrationDate:
                        type: integer
                        format: int64
                        example: 1590186370340
                      serialNumber:
                        type: string
                        example: '12345712'
                      site-id:
                        type: string
                        example: '500'
                      state:
                        type: string
                        example: green
                      status:
                        type: string
                        example: normal
                        enum:
                        - error
                        - warning
                        - normal
                        - new
                      system-ip:
                        type: string
                        example: 172.16.255.15
                      templateStatus:
                        type: string
                        example: Success
                      uuid:
                        type: string
                        example: C8K-cfb84064-12e9-4f7c-b9d9-bf78ce4dfb5f
                      validity:
                        type: string
                        example: valid
                        enum:
                        - invalid
                        - staging
                        - valid
                        - prestaging
                      version:
                        type: string
                        example: 17.06.01.0.1422
                      wanInterfaces:
                        type: array
                        items:
                          type: string
                    $$ref: '#/components/schemas/Device'
                organization:
                  type: string
                validityString:
                  type: string
              $$ref: '#/components/schemas/ClaimDevicesRequest'
            examples:
              Claim device request:
                description: Claim device request
                value:
                  organization: srikann-viptela
                  validityString: valid
                  chassis_list:
                  - chassis-number: ISR4351/K9-FDO23070Y63
                    serial-number: 383CB73
                    subject-serial-number: FDO23070Y63
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiRequestExampleClaimdevices'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  activityList:
                    type: string
                    example: '[Number of vEdges uploaded successfully: 1, Uploaded vEdges (chassis Id, serial number): ,  - ISR4351/K9-FDO23070Y63, 383CB73]'
                  id:
                    type: string
                    example: 7d77139d-5bed-4e82-8ea5-411a588a522e
                  vedgeListUploadMsg:
                    type: string
                    example: ' of vEdges uploaded successfully: 1'
                  vedgeListUploadStatus:
                    type: string
                    example: vEdge list uploaded successfully
                $$ref: '#/components/schemas/ClaimDevicesResponse'
              examples:
                Claimed device info:
                  description: Claimed device info
                  value:
                    vedgeListUploadMsg: ' of vEdges uploaded successfully: 1'
                    vedgeListUploadStatus: vEdge list uploaded successfully
                    id: 7d77139d-5bed-4e82-8ea5-411a588a522e
                    activityList: '[Number of vEdges uploaded successfully: 1, Uploaded vEdges (chassis Id, serial number): ,  - ISR4351/K9-FDO23070Y63, 383CB73]'
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleClaimdevicesresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/controllers/vedge/status:
    get:
      tags:
      - Configuration - Device Inventory
      description: Get controllers vEdge sync status
      operationId: getControllerVEdgeSyncStatus_ConfigurationDeviceInventory_3903
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
              examples:
                vEdge status:
                  description: vEdge status
                  value:
                    data:
                      totalControllers: 4
                      ControllersOutOfSync: 1
                      tenantList:
                      - tenant: tenantName
                        deviceType: vedge
                        chasisNumber: 71001c48-fdcf-4ac0-aaf3-ca4a20386a18
                        serialNumber: f0b1985ba82e4c4889c225c59ca9a878
                        managementSystemIP: 172.18.47.115
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleControllersvedgestatus'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Device Monitoring-read
  /system/device/decommission/{uuid}:
    put:
      tags:
      - Configuration - Device Inventory
      description: Decomission vEdge device
      operationId: decommissionVedgeCloud
      parameters:
      - name: uuid
        in: path
        description: Device uuid
        required: true
        schema:
          type: string
        example: C8K-f9f4a977-be6c-47f7-b3b2-10e916bb24db
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: b2afb474-f943-45b6-b673-f51b393ff924
                $$ref: '#/components/schemas/DecommissionVedgeCloud'
              examples:
                Task id:
                  description: Task id
                  value:
                    id: b2afb474-f943-45b6-b673-f51b393ff924
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleDecommissionuuid'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/devicesWithoutSubjectSudi:
    get:
      tags:
      - Configuration - Device Inventory
      description: retrieve devices without subject sudi
      operationId: devicesWithoutSubjectSudi
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
              examples:
                Devices:
                  description: Devices
                  value: []
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/fileupload:
    post:
      tags:
      - Configuration - Device Inventory
      description: Upload file to vEdge
      operationId: formPost
      requestBody:
        description: Request body for Upload file to vEdge
        content:
          multipart/form-data:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  data:
                    validity: valid
                    upload: true
                  file: binary
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiRequestExampleFileupload'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  activityList:
                    type: string
                    example: '[Number of vEdges uploaded successfully: 1, Uploaded vEdges (chassisId, serial number): ,  - ESR-6300-LIC-K9-FAUSTEST126, 030557201979336385BE]'
                  id:
                    type: string
                    example: b5091b8e-e5ea-4096-8e4c-f17d0d60f2dd
                  vedgeListUploadMsg:
                    type: string
                    example: 'Number of vEdges uploaded successfully: 1'
                  vedgeListUploadStatus:
                    type: string
                    example: vEdge list uploaded successfully
                $$ref: '#/components/schemas/FormPostResp'
              examples:
                Example:
                  description: Example
                  value:
                    vedgeListUploadMsg: 'Number of vEdges uploaded successfully: 1'
                    vedgeListUploadStatus: vEdge list uploaded successfully
                    id: b5091b8e-e5ea-4096-8e4c-f17d0d60f2dd
                    activityList: '[Number of vEdges uploaded successfully: 1, Uploaded vEdges (chassisId, serial number): ,  - ESR-6300-LIC-K9-FAUSTEST126, 030557201979336385BE]'
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleFileuploadresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/generate-payg:
    post:
      tags:
      - Configuration - Device Inventory
      description: Authenticate vSmart user account
      operationId: validateUser
      requestBody:
        description: Request body
        content:
          multipart/form-data:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  numPaygDevices: 2
                  validity: invalid
                  organization: vIPtela Inc Regression
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiRequestExampleGeneratepayg'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example:
                  description: Example
                  value:
                    vedgeListAddMsg: 'Number of PAYG vEdges added successfully: 2'
                    vedgeListAddStatus: PAYG vEdge list added successfully
                    id: 42ce4e4e-aaea-4dcd-9507-037ee42a06e5
                    activityList: '[Number of PAYG vEdges added successfully: 2, Added PAYG vEdges (chassis Id, serial number): ,  - C8K-PAYG-b44-e6aa-4d42-a637-82fd74ec523b, 6573ef62902e447db063dab76613b2c3,  - C8K-PAYG-083-f30e-40b5-80fe-55f401a4839b, aa82b3bb8cda48b7b3693bc70fd1a0bb]'
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleGeneratepaygresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Device Inventory-write,Device Inventory > Edge-write
  /system/device/lifecycle/management/{uuid}:
    post:
      tags:
      - Configuration - Device Inventory
      description: Set device lifecycle needed flag
      operationId: setLifeCycle
      parameters:
      - name: uuid
        in: path
        description: Device uuid
        required: true
        schema:
          type: string
        example: 0cee8b1d-1d2c-4c8b-a111-4b17ce9dd473
      - name: enable
        in: query
        schema:
          type: boolean
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  DeviceLifeCycleNeeded:
                    type: boolean
                    example: false
                $$ref: '#/components/schemas/SetLifeCycle'
              examples:
                Device lifecycle needed value:
                  description: Device lifecycle needed value
                  value:
                    DeviceLifeCycleNeeded: false
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleLifecyclemanagement'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/management/systemip:
    get:
      tags:
      - Configuration - Device Inventory
      description: Get management system IP mapping
      operationId: getManagementSystemIPInfo_ConfigurationDeviceInventory_3403
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                System IP mapping:
                  description: System IP mapping
                  value:
                    data:
                    - deviceType: vbond
                      serialNumber: '12345712'
                      managementSystemIP: 172.16.255.26
                      chasisNumber: b679806c-d107-4c2b-bc80-4665f1ab87a8
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleManagementsystemip'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Device Monitoring-read
  /system/device/migrateDevice/{uuid}:
    put:
      tags:
      - Configuration - Device Inventory
      description: Migrate device software to vedge/cedge
      operationId: migrateDevice
      parameters:
      - name: uuid
        in: path
        description: Device uuid
        required: true
        schema:
          type: string
        example: cad0e65b-86b5-48af-8c26-5a470ea68166
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Device migration result:
                  description: Device migration result
                  value: {}
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleMigratedevice'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/quickconnect/smartaccount/sync:
    post:
      tags:
      - Configuration - Device Inventory
      description: Sync devices from Smart-Account
      operationId: getSmartAccountDevices
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                accessToken:
                  type: string
                clientCredentials:
                  type: boolean
                env:
                  type: string
                organization_name:
                  type: string
                password:
                  type: string
                username:
                  type: string
                validity_string:
                  type: string
              $$ref: '#/components/schemas/SmartAccountModel'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  processId:
                    type: string
                    example: c82d4877-dc04-4580-aedc-3a10166dab4d
                $$ref: '#/components/schemas/SyncDevicesResp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/reset/{uuid}:
    put:
      tags:
      - Configuration - Device Inventory
      description: Reset vEdge device
      operationId: resetVedgeCloud
      parameters:
      - name: uuid
        in: path
        description: Device uuid
        required: true
        schema:
          type: string
        example: cad0e65b-86b5-48af-8c26-5a470ea68166
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 36023ff2-42e9-4074-88d9-75bb995b1411
                $$ref: '#/components/schemas/ResetVedgeCloud'
              examples:
                Task id:
                  description: Task id
                  value:
                    id: 36023ff2-42e9-4074-88d9-75bb995b1411
                  $$ref: '#/components/examples/ComViptelaVmanageServerBootstrapDevicelifecycleapiResponseExampleReset'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/rma/candidates/{deviceType}:
    get:
      tags:
      - Configuration - Device Inventory
      description: Get RMA candidates by device type
      operationId: getRMACandidates
      parameters:
      - name: deviceType
        in: path
        description: deviceType
        required: true
        schema:
          type: string
        example: controller
      - name: uuid
        in: query
        description: uuid
        schema:
          type: string
        example: ec7af44a-8731-442d-9b5e-62f3dc407454
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  deviceIP:
                    type: string
                    example: 172.16.255.19
                  host-name:
                    type: string
                    example: vm-9
                  managementSystemIP:
                    type: string
                    example: 172.16.255.19
                  uuid:
                    type: string
                    example: ec7af44a-8731-442d-9b5e-62f3dc407454
                  validity:
                    type: string
                    example: valid
                $$ref: '#/components/schemas/GetRMACandidates'
              examples:
                Device type:
                  description: Device type
                  value:
                    uuid: ec7af44a-8731-442d-9b5e-62f3dc407454
                    deviceIP: 172.16.255.19
                    validity: valid
                    managementSystemIP: 172.16.255.19
                    host-name: vm-9
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceconfigSystemDeviceSystemdeviceapiResponseExampleRmacandidates'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /system/device/rootcertchain/status:
    get:
      tags:
      - Configuration - Device Inventory
      description: Get controllers vEdge sync status
      operationId: getRootCertStatusAll
      parameters:
      - name: state
        in: query
        description: state
        required: true
        schema:
          type: string
        example: pending/done
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                   

# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-catalyst-sdwan/refs/heads/main/openapi/cisco-catalyst-sdwan-configuration-device-inventory-api-openapi.yml