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-actions-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Others Configuration - Device Actions 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 Actions
paths:
  /device/action/cancel:
    post:
      tags:
      - Configuration - Device Actions
      description: Cancel tasks
      operationId: processCancelTask
      requestBody:
        description: Request body
        content:
          application/json:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  action: cancel
                  devices:
                  - processId: software_install-xyz
                    deviceIP: 172.16.255.21
                    deviceId: 13cf949c-9192-4c5d-8096-12c41fbd366d
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExampleCancel'
        required: true
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /device/action/changepartition:
    get:
      tags:
      - Configuration - Device Actions
      description: Get change partition information
      operationId: generateChangePartitionInfo
      parameters:
      - name: deviceId
        in: query
        description: deviceId - Device IP
        required: true
        schema:
          type: array
          items:
            type: object
            properties:
              deviceIp:
                type: string
            description: This is the valid DeviceIP
            $$ref: '#/components/schemas/DeviceIP'
        example:
        - 172.16.255.15
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example:
                  description: Example
                  value:
                    data:
                    - availableVersions:
                      - string
                      host-name: vm1
                      system-ip: 172.16.255.11
                      personality: vedge
                      site-id: '100'
                      uuid: 0fd462aa-f885-44e4-8b7e-843b5aa4040b
                      device-type: vedge
                      version: 20.10.999-1966
                      uptime-date: '1652858640000'
                      device-model: vedge-cloud
                      platform: x86_64
                      reachability: reachable
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleGetchangepartitionresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
    post:
      tags:
      - Configuration - Device Actions
      description: Process change partition operation
      operationId: processChangePartition
      requestBody:
        description: Request body for Process change partition operation
        content:
          application/json:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  action: changepartition
                  devices:
                  - version: 20.3.0
                    deviceIP: 172.16.51.1
                    deviceId: 52fe5cd3-ec3d-4141-92e4-0c31d0e0347a
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExamplePostchangepartitionreq'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example Value:
                  description: Example Value
                  value:
                    id: change_partition-99b8ebd5-c8cf-439b-8504-2f80b0b75b73
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExamplePostchangepartitionresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /device/action/deactivate:
    get:
      tags:
      - Configuration - Device Actions
      description: Get deactivate partition information
      operationId: generateDeactivateInfo
      parameters:
      - name: deviceId
        in: query
        description: deviceId - Device IP
        required: true
        schema:
          type: array
          items:
            type: object
            properties:
              deviceIp:
                type: string
            description: This is the valid DeviceIP
            $$ref: '#/components/schemas/DeviceIP'
        example:
        - 172.16.255.15
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        availableVersions:
                          type: array
                          example: []
                          items:
                            type: string
                            example: []
                        device-model:
                          type: string
                          example: vedge-C8000V
                        device-type:
                          type: string
                          example: vedge
                        host-name:
                          type: string
                          example: vm5
                        personality:
                          type: string
                          example: vedge
                        platform:
                          type: string
                          example: x86_64
                        reachability:
                          type: string
                          example: reachable
                        site-id:
                          type: string
                          example: '500'
                        system-ip:
                          type: string
                          example: 172.16.255.15
                        uptime-date:
                          type: string
                          example: '1686317760000'
                        uuid:
                          type: string
                          example: C8K-a06af989-6a80-472d-ac0f-ed5560b5068b
                        version:
                          type: string
                          example: 17.13.01.0.180213
                      $$ref: '#/components/schemas/GenerateDeactivateInfoData'
                $$ref: '#/components/schemas/GenerateDeactivateInfo'
              examples:
                Get deactivate partition information example:
                  description: Get deactivate partition information example
                  value:
                    data:
                    - availableVersions: []
                      host-name: vm5
                      system-ip: 172.16.255.15
                      personality: vedge
                      site-id: '500'
                      uuid: C8K-a06af989-6a80-472d-ac0f-ed5560b5068b
                      device-type: vedge
                      version: 17.13.01.0.180213
                      uptime-date: '1686317760000'
                      device-model: vedge-C8000V
                      platform: x86_64
                      reachability: reachable
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleGetdeactivateresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Software Upgrade-read,Software Upgrade-write,Software Upgrade > Edge-write,Software Upgrade > Edge-read,Software Upgrade > Controller-write,Software Upgrade > Controller-read
    post:
      tags:
      - Configuration - Device Actions
      description: Process deactivate operation for smu image
      operationId: processDeactivateSmu
      requestBody:
        description: Device smu image deactivate request
        content:
          application/json:
            schema:
              type: object
            examples:
              Device deactivate request:
                description: Device deactivate request
                value:
                  action: deactivate
                  devices:
                  - version: 20.3.0
                    deviceIP: 172.16.51.1
                    deviceId: 52fe5cd3-ec3d-4141-92e4-0c31d0e0347a
                  - version: 20.3.0
                    deviceIP: 172.16.51.2
                    deviceId: 4d4507df-29b4-4f68-9129-36cfa4528847
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExamplePostdeactivatereq'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Task Id:
                  description: Task Id
                  value:
                    id: deactivate-01232017T154359940
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExamplePostdeactivateresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Software Upgrade-write,Software Upgrade > Edge-write,Software Upgrade > Controller-write
  /device/action/defaultpartition:
    post:
      tags:
      - Configuration - Device Actions
      description: Process marking default partition operation
      operationId: processDefaultPartition
      requestBody:
        description: Request body for Process marking default partition operation
        content:
          application/json:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  action: defaultpartition
                  devices:
                  - version: 99.99.999-2499
                    deviceIP: 172.16.255.16
                    deviceId: 13cf949c-9192-4c5d-8096-12c41fbd366d
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExamplePostdefaultpartitionreq'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example:
                  description: Example
                  value:
                    id: default_partition-99b8ebd5-c8cf-439b-8504-2f80b0b75b73
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExamplePostdefaultpartitionresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /device/action/filter/vpn:
    get:
      tags:
      - Configuration - Device Actions
      description: Get filter VPN list
      operationId: createFilterVPNList
      parameters:
      - name: site-id
        in: query
        description: site-id
        schema:
          type: string
        example: 500
      - name: deviceId
        in: query
        description: deviceId
        schema:
          type: string
        example: 172.16.255.14
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  vedge:
                    type: array
                    items:
                      type: string
                  vsmart:
                    type: array
                    items:
                      type: string
                $$ref: '#/components/schemas/CreateFilterVPNList'
              examples:
                Example:
                  description: Example
                  value:
                    vedge:
                    - '1'
                    - '65528'
                    - '65530'
                    - '65529'
                    vsmart: []
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleFiltervpnresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Software Upgrade-read,RBAC VPN-read,Software Upgrade > Edge-read,Software Upgrade > Controller-read
  /device/action/image-download:
    post:
      tags:
      - Configuration - Device Actions
      description: Intitate image download on the given device.
      operationId: initiateImageDownload
      requestBody:
        description: Request body to Intitate image download on the given device
        content:
          application/json:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  action: image-download
                  actionName: Test
                  actionStart: Tue Jan 11 23:00:00 IST 2022
                  actionStartMillis: 1641922200000
                  actionEnd: Wed Jan 12 03:00:00 IST 2022
                  actionEndMillis: 1641936600000
                  timeZone: Asia/Kolkata
                  actionTimeoutMins: 30
                  input:
                    data:
                    - family: c800v
                      version: 875d4845-df12-4fdf-91f6-b73c601b2c3f
                      remoteServerId: 192448a2-36bd-4f50-af04-03b428cd5a8f
                    versionType: remote
                  devices:
                  - deviceIP: 40.1.1.1
                    deviceId: C8K-60c01ff3-1405-428f-93e9-f1606d22968e
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExampleImagedownload'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example:
                  description: Example
                  value:
                    task_id: default_partition-01112017T159951140
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleImagedownloadresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /device/action/image-remove:
    post:
      tags:
      - Configuration - Device Actions
      description: Process remove software image operation
      operationId: processRemoveSoftwareImage
      requestBody:
        description: Request body - Process remove software image operation
        content:
          application/json:
            schema:
              type: object
            examples:
              Example Value:
                description: Example Value
                value:
                  action: image-remove
                  devices:
                  - deviceIP: 172.16.255.21
                    deviceId: 2b24a7be-077c-48f7-873f-47573986d148
                    images:
                    - viptela-20.4.2-x86_64.tar.gz
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExampleImageremove'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example:
                  description: Example
                  value:
                    id: image_remove-0a58029a-db1d-4d82-9400-3c867c8be533
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleImageremoveresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /device/action/install:
    post:
      tags:
      - Configuration - Device Actions
      description: Process an installation operation
      operationId: processInstall
      requestBody:
        description: Request body
        content:
          application/json:
            schema:
              required:
              - action
              type: object
              properties:
                action:
                  type: string
                  example: install
                actionEnd:
                  type: string
                  description: Scheduled time for the action to end.
                  example: Wed Nov 06 2024 15:27:32
                actionEndMillis:
                  type: integer
                  description: Scheduled time in EPHOC millis for the action to end.
                  format: int32
                  example: 1730887052000
                actionStart:
                  type: string
                  description: Scheduled time for the action to start.
                  example: Wed Nov 06 2024 11:27:32
                actionStartMillis:
                  type: integer
                  description: Scheduled time in EPHOC millis for the action to start.
                  format: int32
                  example: 1730872652000
                deviceType:
                  type: string
                  example: vedge
                devices:
                  type: array
                  items:
                    required:
                    - deviceIP
                    - deviceId
                    type: object
                    properties:
                      deviceIP:
                        type: string
                        description: Device IP address.
                        example: 172.16.255.14
                      deviceId:
                        type: string
                        description: Device ID.
                        example: 2f876a33-9944-450a-91ee-f1f80eb68348
                    $$ref: '#/components/schemas/ProcessInstallReqDevices'
                input:
                  required:
                  - data
                  - vEdgeVPN
                  - vSmartVPN
                  - versionType
                  type: object
                  properties:
                    data:
                      type: array
                      description: Device action input data.
                      items:
                        required:
                        - family
                        - version
                        type: object
                        properties:
                          family:
                            type: string
                            description: Platform family of the software image.
                            example: c800v
                          version:
                            type: string
                            description: Version of the software image.
                            example: 17.17.01.0.209664.1728238032
                          versionId:
                            type: string
                            description: Version id of the software image.
                            example: 824ac3d6-7d2a-4dfa-8a8b-e6e5bc64acb8
                        description: Device action input data.
                        $$ref: '#/components/schemas/ProcessInstallReqInputData'
                    reboot:
                      type: boolean
                      example: false
                    sync:
                      type: boolean
                      example: true
                    vEdgeVPN:
                      type: integer
                      description: VPN id of the vEdge.
                      format: int32
                      example: 0
                    vSmartVPN:
                      type: integer
                      description: VPN id of the vSmart.
                      format: int32
                      example: 0
                    versionType:
                      type: string
                      description: Version type of the software image.
                      example: vmanage
                  $$ref: '#/components/schemas/ProcessInstallReqInput'
                timeZone:
                  type: string
                  description: Scheduled time zone for the action.
                  example: UTC
              $$ref: '#/components/schemas/ProcessInstallReq'
            examples:
              Example Value:
                description: Example Value
                value:
                  action: install
                  input:
                    vEdgeVPN: 0
                    vSmartVPN: 0
                    data:
                    - family: c8000v
                      version: 17.17.01.0.209664.1728238032
                      versionId: 824ac3d6-7d2a-4dfa-8a8b-e6e5bc64acb8
                    versionType: vmanage
                    reboot: false
                    sync: true
                  devices:
                  - deviceIP: 172.16.255.14
                    deviceId: 2f876a33-9944-450a-91ee-f1f80eb68348
                  deviceType: vedge
                $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiRequestExampleInstall'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Task Id:
                  description: Task Id
                  value:
                    id: software_install-01232017T154359940
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleInstallresppost'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
    get:
      tags:
      - Configuration - Device Actions
      description: Generate install info
      operationId: generateInstallInfo
      parameters:
      - name: deviceId
        in: query
        description: deviceId - Device IP
        required: true
        schema:
          type: array
          items:
            type: object
            properties:
              deviceIp:
                type: string
            description: This is the valid DeviceIP
            $$ref: '#/components/schemas/DeviceIP'
        example:
        - 172.16.255.15
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              examples:
                Example:
                  description: Example
                  value:
                    data:
                    - device-model: vedge-cloud
                      device-os: next
                      local-system-ip: 172.16.255.11
                      system-ip: 172.16.255.11
                      site-id: '100'
                      downloadedImages:
                      - string
                      uuid: 0fd462aa-f885-44e4-8b7e-843b5aa4040b
                      platform: x86_64
                      isScheduleUpgradeSupported: true
                      personality: vedge
                      device-type: vedge
                      reachability: reachable
                      availableVersions:
                      - string
                      downloadedServices:
                      - string
                      availableServices:
                      - string
                      host-name: vm1
                      version: 20.10.999-1966
                      uptime-date: 1652858640000
                      isMultiStepUpgradeSupported: true
                      defaultVersion: 20.10.999-1966
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleInstallrespget'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
  /device/action/install/devices/{deviceType}:
    get:
      tags:
      - Configuration - Device Actions
      description: Get list of installed devices
      operationId: generateDeviceList
      parameters:
      - name: deviceType
        in: path
        description: Device type
        required: true
        schema:
          type: string
        example: vmanage
      - name: groupId
        in: query
        description: groupId
        schema:
          type: string
        example: all
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    example:
                      device-model: vmanage
                      device-os: next
                      local-system-ip: 172.16.255.22
                      system-ip: 172.16.255.22
                      site-id: '200'
                      uuid: b642c56f-c899-4ca4-a3d6-d915e0660f9a
                      platform: x86_64
                      isScheduleUpgradeSupported: false
                      personality: vmanage
                      device-type: vmanage
                      reachability: reachable
                      availableVersions: []
                      host-name: vm12
                      version: 20.13.999-2846
                      layoutLevel: 1
                      uptime-date: 1683523320000
                      isMultiStepUpgradeSupported: false
                      defaultVersion: 20.13.999-2846
                      platformFamily: vmanage
                      current-partition: 20.13.999-2846
                    items:
                      type: object
                      properties:
                        availableVersions:
                          type: array
                          items:
                            type: string
                        current-partition:
                          type: string
                        defaultVersion:
                          type: string
                        device-model:
                          type: string
                        device-os:
                          type: string
                        device-type:
                          type: string
                        host-name:
                          type: string
                        isMultiStepUpgradeSupported:
                          type: boolean
                        isScheduleUpgradeSupported:
                          type: boolean
                        layoutLevel:
                          type: integer
                          format: int32
                        local-system-ip:
                          type: string
                        personality:
                          type: string
                        platform:
                          type: string
                        platformFamily:
                          type: string
                        reachability:
                          type: string
                        site-id:
                          type: string
                        system-ip:
                          type: string
                        uptime-date:
                          type: integer
                          format: int32
                        uuid:
                          type: string
                        version:
                          type: string
                      example:
                        device-model: vmanage
                        device-os: next
                        local-system-ip: 172.16.255.22
                        system-ip: 172.16.255.22
                        site-id: '200'
                        uuid: b642c56f-c899-4ca4-a3d6-d915e0660f9a
                        platform: x86_64
                        isScheduleUpgradeSupported: false
                        personality: vmanage
                        device-type: vmanage
                        reachability: reachable
                        availableVersions: []
                        host-name: vm12
                        version: 20.13.999-2846
                        layoutLevel: 1
                        uptime-date: 1683523320000
                        isMultiStepUpgradeSupported: false
                        defaultVersion: 20.13.999-2846
                        platformFamily: vmanage
                        current-partition: 20.13.999-2846
                      $$ref: '#/components/schemas/GenerateDeviceListData'
                $$ref: '#/components/schemas/GenerateDeviceList'
              examples:
                Example:
                  description: Example
                  value:
                    data:
                      device-model: vmanage
                      device-os: next
                      local-system-ip: 172.16.255.22
                      system-ip: 172.16.255.22
                      site-id: '200'
                      uuid: b642c56f-c899-4ca4-a3d6-d915e0660f9a
                      platform: x86_64
                      isScheduleUpgradeSupported: false
                      personality: vmanage
                      device-type: vmanage
                      reachability: reachable
                      availableVersions: []
                      host-name: vm12
                      version: 20.13.999-2846
                      layoutLevel: 1
                      uptime-date: 1683523320000
                      isMultiStepUpgradeSupported: false
                      defaultVersion: 20.13.999-2846
                      platformFamily: vmanage
                      current-partition: 20.13.999-2846
                  $$ref: '#/components/examples/ComViptelaVmanageServerDeviceactionDeviceactionapiResponseExampleGetinstalldevicesresp'
        '400':
          description: Bad Request
        '403':
          description: Forbidden
        '500':
          description: Internal Server Error
      x-roles-required: Software Upgrade-read,Software Upgrade-write,Settings-read,vmanage-http-stream,Software Upgrade > Edge-write,Software Upgrade > Edge-read,Software Upgrade > Controller-write,Software Upgrade > Controller-read
  /device/action/list:
    get:
      tags:
      - Configuration - Device Actions
      description: Get device action list
      operationId: generateDeviceActionList
      responses:
        '200':
          description: Success
          content:
            application/json:
             

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