NetStacksNetStacks

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.