For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
    • NVIDIA Switch Infrastructure
    • I want to...
  • Quick Start
    • Start Here
    • Getting Started with Config Manager
    • TUI Wizard Reference
    • Configuration Samples
    • Interfaces
    • Local Development Quick Start
    • First Run Tour
  • Config Manager Overview
    • Config Manager Concepts
    • Getting Started with Nautobot
  • User Guides
    • New Site Bringup
    • Workflow Lifecycle
  • Deployment
    • Hosting Options
    • Network Topology Requirements
    • Firewall Ports
    • Airgapped Deployment
    • Troubleshooting
  • Services
      • Overview
      • Architecture
        • GETCurrent User Info
          • GETCheck cache service status
          • GETTest cache lookup for a device
          • GETList all devices
          • GETSearch devices by name with latest config info
          • DELPermanently delete all configs for a device
          • GETGet database statistics
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogo
ServicesConfig Store ServiceConfig Store APIadmin

Search devices by name with latest config info

||View as Markdown|
GET
https://host.com/v1/admin/devices/search
GET
/v1/admin/devices/search
$curl https://host.com/v1/admin/devices/search \
>     -H "Content-Type: application/json"
1[
2  {
3    "latest_author": "jdoe",
4    "latest_message": "Updated interface descriptions and VLAN assignments",
5    "latest_update": "2024-06-10T15:42:00Z",
6    "name": "core-switch-01",
7    "site": "New York Data Center",
8    "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
9    "active": true
10  }
11]
Search devices by name with their latest configuration metadata. If q is not provided, returns the 100 most recently updated devices from DB. If q is provided, uses Redis cache to find matching device names and their UUIDs, then fetches their latest config info from DB. Results are sorted by most recent update first. Results are filtered by file_type (intended or backup). Inactive devices (removed from nv_config_manager/Nautobot) are hidden unless include_inactive is True.
Previous

List all devices

Next

Permanently delete all configs for a device

Search devices by name with their latest configuration metadata.

If q is not provided, returns the 100 most recently updated devices from DB. If q is provided, uses Redis cache to find matching device names and their UUIDs, then fetches their latest config info from DB. Results are sorted by most recent update first. Results are filtered by file_type (intended or backup). Inactive devices (removed from nv_config_manager/Nautobot) are hidden unless include_inactive is True.

Query parameters

qstring or nullOptional
limitintegerOptionalDefaults to 100
file_typeenumOptional
Enum for config file types.
Allowed values:
include_inactivebooleanOptionalDefaults to false

Response

Successful Response
latest_authorstring
Author of latest change
latest_messagestring
Commit message of latest change
latest_updatestring
Latest config update timestamp
namestring
Device name
sitestring
Site name
uuidstring
Device UUID
activebooleanDefaults to true

Whether the device is currently active in nv-config-manager

Errors

422
Unprocessable Entity Error