# Mist (Juniper Mist Cloud API)

> AI-driven cloud platform for wireless, wired, and WAN networking. The Juniper Mist Cloud API is a RESTful HTTPS/JSON API (OpenAPI 3.1, 748 paths / 1050 operations) organized around an Org -> Site -> Device hierarchy. Token authentication (Basic Auth deprecated Sept 2026); 5000 requests/hour quota; org/site webhooks plus WebSocket streaming; 12 regional hosts.

## API

- [Juniper Mist Cloud API docs](https://www.juniper.net/documentation/us/en/software/mist/automation-integration/): Automation & integration guide.
- [API reference](https://www.juniper.net/documentation/us/en/software/mist/api/http/): Interactive endpoint reference.
- [Getting started](https://www.mist.com/documentation/category/getting-started-api/): First API calls and token setup.
- Base URL: https://api.mist.com/api/v1 (substitute "api" for "manage" in your portal host for other regions).

## Specs

- [OpenAPI 3.1 spec](openapi/mist-openapi-original.json): mistsys/mist_openapi, 1050 operations.
- [OpenAPI overlay](overlays/mist-openapi-overlay.yaml): API Evangelist enhancements.

## Artifacts

- [Authentication](authentication/mist-authentication.yml): API token + CSRF/session.
- [Conventions](conventions/mist-conventions.yml): pagination, regions, rate-limit signaling.
- [Rate limits](rate-limits/mist-rate-limits.yml): 5000/hour, 429 on exceed.
- [Errors](errors/mist-problem-types.yml): JSON {detail} envelope.
- [Lifecycle](lifecycle/mist-lifecycle.yml): versioning + Basic Auth deprecation.
- [Changelog](changelog/mist-changelog.yml): calendar-versioned recent entries.
- [Webhooks](asyncapi/mist-webhooks.yml): org/site event subscriptions + topics.
- [Data model](data-model/mist-data-model.yml): Org/Site/Device/Client graph.
- [MCP tools (candidate)](mcp/mist-mcp.yml): derived agent tool surface.
- [Agent skills](skills/_index.yml): packaged operating instructions.
- [Packages](packages/mist-packages.yml): Terraform provider, Python SDK.

## Source

- [GitHub org (mistsys)](https://github.com/mistsys)
- [Postman workspace](https://www.postman.com/juniper-mist/)
- [Status page](https://status.mist.com/)