Cisco Hardware

Cisco Hardware Devices API

The Devices API from Cisco Hardware — 3 operation(s) for devices.

Documentation GitHub OpenAPI

Operations 5

GET /dna/intent/api/v1/network-device Get device list #

POST /dna/intent/api/v1/network-device Add a device #

GET /dna/intent/api/v1/network-device/{id} Get device by id #

DELETE /dna/intent/api/v1/network-device/{id} Delete device by id #

GET /dna/intent/api/v1/network-device/count Get device count #

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-hardware-devices-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: Cisco Catalyst Center (DNA Center) Intent Authentication Devices API
  description: 'The Cisco Catalyst Center (formerly DNA Center) Intent API provides

    programmatic management of Cisco enterprise network hardware, including

    discovery, inventory, provisioning, assurance, software image

    management, sites, and command runner. Authentication uses a basic-auth

    token exchange against /dna/system/api/v1/auth/token; the returned

    token is sent on subsequent requests as the X-Auth-Token header.

    '
  version: 1.0.0
  contact:
    name: Cisco DevNet
    url: https://developer.cisco.com/docs/dna-center/
  x-provenance:
    method: derived
    authored_by: API Evangelist
    derived_on: '2026-08-19'
    first_party: false
    provider_published: false
    source: Modelled from the provider's public HTML documentation.
    note: 'Not published by the provider. Probed 2026-08-19: no anonymously fetchable first-party contract. No fetchable contract found on Cisco''s developer properties.'
servers:
- url: https://{controllerHost}
  variables:
    controllerHost:
      default: sandboxdnac.cisco.com
      description: Host of the Catalyst Center controller
security:
- tokenAuth: []
tags:
- name: Devices
paths:
  /dna/intent/api/v1/network-device:
    get:
      tags:
      - Devices
      summary: Get device list
      operationId: getDeviceList
      parameters:
      - in: query
        name: hostname
        schema:
          type: array
          items:
            type: string
      - in: query
        name: managementIpAddress
        schema:
          type: array
          items:
            type: string
      - in: query
        name: macAddress
        schema:
          type: array
          items:
            type: string
      - in: query
        name: family
        schema:
          type: array
          items:
            type: string
      - in: query
        name: serialNumber
        schema:
          type: array
          items:
            type: string
      - in: query
        name: limit
        schema:
          type: integer
      - in: query
        name: offset
        schema:
          type: integer
      responses:
        '200':
          description: Device list
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: array
                    items:
                      $ref: '#/components/schemas/Device'
                  version:
                    type: string
    post:
      tags:
      - Devices
      summary: Add a device
      operationId: addDevice
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ipAddress:
                  type: array
                  items:
                    type: string
                snmpVersion:
                  type: string
                snmpROCommunity:
                  type: string
                snmpRWCommunity:
                  type: string
                cliTransport:
                  type: string
                userName:
                  type: string
                password:
                  type: string
                enablePassword:
                  type: string
      responses:
        '202':
          description: Task accepted
  /dna/intent/api/v1/network-device/{id}:
    parameters:
    - in: path
      name: id
      required: true
      schema:
        type: string
    get:
      tags:
      - Devices
      summary: Get device by id
      operationId: getDeviceById
      responses:
        '200':
          description: A device
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    $ref: '#/components/schemas/Device'
    delete:
      tags:
      - Devices
      summary: Delete device by id
      operationId: deleteDeviceById
      responses:
        '202':
          description: Task accepted
  /dna/intent/api/v1/network-device/count:
    get:
      tags:
      - Devices
      summary: Get device count
      operationId: getDeviceCount
      responses:
        '200':
          description: Count
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: integer
                  version:
                    type: string
components:
  schemas:
    Device:
      type: object
      properties:
        id:
          type: string
        hostname:
          type: string
        managementIpAddress:
          type: string
        macAddress:
          type: string
        platformId:
          type: string
        family:
          type: string
        type:
          type: string
        series:
          type: string
        softwareType:
          type: string
        softwareVersion:
          type: string
        serialNumber:
          type: string
        upTime:
          type: string
        lastUpdateTime:
          type: integer
        location:
          type: string
        reachabilityStatus:
          type: string
        role:
          type: string
        snmpContact:
          type: string
        snmpLocation:
          type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    tokenAuth:
      type: apiKey
      in: header
      name: X-Auth-Token