Automation with APIs

Postman Runner Collection

This is a small video by Jake Snyder on how to access the public Mist Runner collections on Postman.

Automation for Access Switching using Postman

This is an example of using Postman to immediatly use the API to do usful things.  Andy also shows you how to use the Chrome developer tools to figure out exactly which API endpoint is being called and how to take advantage of that in Postman.  It is really the non-programmer way to approach the...

API with Wired Assurance

The API provides the same functionality as the UI, but through a programmable interface.  There are primarily 3 main URI endpoints of interest with respect to Wired Assurance. API Endpoints: Network Templates: Documentation is located just below RF Templates here: https://api.mist.com/api/v1/docs/Org#rf-template Create Network Template POST: https://api.mist.com/api/v1/orgs/:org_id/networktemplates Payload: JSON Formatted Payload Required: name Get List of...

Mist API Architecture

The diagram below conceptually describes how the Mist cloud API can be used to control remote Mist network infrastructure.

HTTPS Response Codes

The full list of HTTP response codes and definitions can be found here: https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html Mist uses the following response codes: Status Description 200 OK 400 Bad Request. The API endpoint exists but its syntax/payload is incorrect, detail may be given 401 Unauthorized 403 Permission Denied 404 Not found. The API endpoint doesn’t exist or resource...

Paged AP Inventory [API]

When using API calls to view all APs, you may paginate the list to indicate the current page and maximum number of objects returned in each page.  This is for an effort to support sites with very large AP inventories. Please refer to our API document (Mist login required) for the usage: https://api.mist.com/api/v1/docs/Overview#query An example...

Mist API Introduction

From the beginning Mist has been a 100% API company.  The API contains a set of tools known as endpoints for building software and applications that communicate with the Mist cloud.  The Dashboard API is a modern, RESTful API using HTTPS requests to a URL and JSON as a human-readable format. The API is available...

Create a Local Python Environment

Overview Install Python 3 following the installation guide: https://docs.python-guide.org/starting/installation OS X Install HomeBrew Go to http://brew.sh. Copy the Homebrew bootstrap code under “Install Homebrew”. Launch the Terminal.app application to open a console window. Paste the Homebrew bootstrap code and begin the installation. If prompted to install Apple’s “command line developer tools,” confirm by clicking the Install button. Follow the prompts...

How do I find my Org and Site ID?

To find your org_id or site_id, simply navigate to the Organization -> Settings page (org_id) or the Organization -> Site Configuration -> <Site Name> (site_id).  As depicted in the screenshots   Alternatively, when you are logged into your Mist UI you can find them in the URL as shown.  AP page is used as a reference.

Simple API example

See If You’re Logged in Already Get ‘whoami’ and privileges (which organization and sites I have access to) GET /api/v1/self For my test account, it returned: This is because I ran it in a new tab on a browser which I’m currently logged in to.