API Reference
REST API reference for the NetStacks Controller: authentication, devices, profiles, templates, stacks, backups, MOPs, tasks, administration, and errors.
11 articles
API Overview
The NetStacks Controller REST API: base URL, authentication, the built-in Swagger UI, conventions, permissions, and a map of the resource groups.
Authentication
Log in to the NetStacks Controller API, send the bearer token, refresh it, and manage sessions. Covers local, LDAP, and OIDC login endpoints.
Devices API
List, create, update, import, and delete devices in the NetStacks Controller inventory, plus sites and NetBox sources.
Connection Profiles API
Manage NetStacks Controller connection profiles and their encrypted secrets (passwords, SSH keys, SNMP communities, API tokens) through the API.
Templates API
Create, version, and render NetStacks Controller config templates through the API, and list the automation platforms they target.
Stacks & Deployments API
Create config stacks, preview what they render per device, save instances, run deployments, follow their logs, and roll back through the NetStacks Controller API.
Config Backups API
Pull device configurations, read stored versions, compare versions, and run backup snapshots across many devices with the NetStacks Controller API.
MOPs API
List, review, and approve Methods of Procedure (MOPs) and read MOP execution history through the NetStacks Controller API.
Scheduled Tasks & Jobs API
Create and manage NetStacks Controller scheduled tasks (backups, deployments, health checks, scripts, AI agent tasks), run them on demand, and read job history.
Administration API
Manage NetStacks Controller users, roles, organizations, settings, and license, and read the audit log through the API.
Errors
The error format and HTTP status codes returned by the NetStacks Controller API, and how to handle them in scripts.
Need Help?
Can't find what you're looking for? Browse all documentation or get in touch.