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
      • Network Infrastructure Automation with Temporal
      • Temporal Deployment Process
      • Temporal CLI
      • Workflows for Day 2 Operations
      • Temporal API
        • GETHealthcheck
        • GETRBAC Config Status
        • GETCurrent User Info
          • GETGet Devices
          • GETGet Device ID by Name
          • GETGet Device Password Users
          • GETGet Secret Types for Device
          • GETGet Device Secrets
          • GETGet Diagnostics Commands
          • GETGet Locations
          • GETGet Roles
          • GETGet AIR Simulations
          • GETGet Sites
          • GETGet Statuses
          • GETGet Tenants
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
ServicesTemporal ServiceTemporal APIparameters

Get Roles

||View as Markdown|
GET
https://host.com/v1/parameter/role
GET
/v1/parameter/role
$curl -G https://host.com/v1/parameter/role \
> -H "Content-Type: application/json" \
> -d managed_only=true
1[
2 {
3 "id": "role-001",
4 "name": "Administrator"
5 },
6 {
7 "id": "role-002",
8 "name": "Developer"
9 },
10 {
11 "id": "role-003",
12 "name": "Operator"
13 }
14]

Return a list of roles. Default: all. With managed_only=true: only those with managed devices.

Previous

Get Locations

Next

Get AIR Simulations

Query parameters

managed_onlybooleanOptionalDefaults to false
Limit to roles with managed devices

Response

Successful Response
idstring
namestring

Errors

422
Unprocessable Entity Error