How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Mist Sites Maps API

A Site Map is a visual representation of the layout and structure of a location, such as a building or campus.It includes accurate information about the placement, positions, heights, and orientations of Juniper Mist Access Points (APs) and other devices in the deployment.The floorplan is an essential component of location services as it enables the location engine to generate accurate location estimates for client devices, assets, and users at the site.

Mist Sites Maps API is one of 212 APIs that Mist publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Sites Maps. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 13 operations across 9 paths, and defines 55 schemas. It is described by OpenAPI 3.2.0, at version 2606.1.1.

Requests are made against 12 base URLs: https://api.mist.com, https://api.gc1.mist.com, https://api.ac2.mist.com, https://api.gc2.mist.com, https://api.gc4.mist.com, https://api.eu.mist.com, https://api.gc3.mist.com, https://api.ac6.mist.com, https://api.gc6.mist.com, https://api.ac5.mist.com, https://api.gc5.mist.com, https://api.gc7.mist.com.

13 operations 9 paths 55 schemas 2 DELETE2 GET8 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2606.1.1
Base URL
https://api.mist.com/api/v1
Authentication
API Key, API Key
License
Resource Areas
1

Authentication & Security 2

Mist Sites Maps API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (apiToken). An API key is passed in the header as X-CSRFToken (csrfToken). By default, every request must be authenticated.

  • apiToken — Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header. Format: Authorization: Token {apitoken} N…
  • csrfToken — Session-based authentication for browser or login/password flows. After a successful [Login](/operations/login) request, Mist returns a csrftoken cookie. Send…

Paths & Operations 13

Across 9 paths, the API surfaces 13 operations — 2 DELETE, 2 GET, 8 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Sites Maps 13

A Site Map is a visual representation of the layout and structure of a location, such as a building or campus. It includes accurate information about the placement, positions, hei…

GET
/api/v1/sites/{site_id}/maps
listSiteMaps
listSiteMaps 4 params → 200400401403404429
POST
/api/v1/sites/{site_id}/maps
createSiteMap
createSiteMap 1 param body → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/auto_geofences
startSiteMapsAutoGeofence
startSiteMapsAutoGeofence 1 param → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/import
importSiteMaps
importSiteMaps 1 param body → 200400401403404429
DELETE
/api/v1/sites/{site_id}/maps/{map_id}
deleteSiteMap
deleteSiteMap 2 params → 200400401403404429
GET
/api/v1/sites/{site_id}/maps/{map_id}
getSiteMap
getSiteMap 2 params → 200400401403404429
PUT
/api/v1/sites/{site_id}/maps/{map_id}
updateSiteMap
updateSiteMap 2 params body → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/{map_id}/auto_geofences
startSiteMapAutoGeofence
startSiteMapAutoGeofence 2 params → 200400401403404429
DELETE
/api/v1/sites/{site_id}/maps/{map_id}/image
deleteSiteMapImage
deleteSiteMapImage 2 params → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/{map_id}/image
addSiteMapImage
addSiteMapImage 2 params body → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/{map_id}/replace
replaceSiteMapImage
replaceSiteMapImage 2 params body → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/{map_id}/set_map
bulkAssignSiteApsToMap
bulkAssignSiteApsToMap 2 params body → 200400401403404429
POST
/api/v1/sites/{site_id}/maps/{map_id}/wayfinding/import
importSiteWayfindings
importSiteWayfindings 2 params body → 200400401403404429

Schemas 55

The contract defines 55 schemas that model the data the API accepts and returns. The most detailed are map (31 properties), map_jibestream (9 properties), response_map_import_ap (7 properties), response_map_import (5 properties). Each schema is shown below with its type and property counts.

map_type
string
Map type, such as image or google. enum: google, image
org_id
string
Unique identifier of a Mist organization
maps
array
Maps or floorplans returned by the API
response_map_import_summary
object
Counts summarizing assignments made during the map import
3 properties 3 required
map
object
Map or floorplan metadata for a site or organization
31 properties
map_wayfinding_path
object
JSON blob for wayfinding (using Dijkstra’s algorithm)
2 properties
map_micello
object
Micello map import configuration
4 properties 4 required
response_http403
object
Standard HTTP 403 permission error response
1 property
mac_addresses_macs
array
Unique MAC addresses included in a request
response_set_devices_map_moved
array
AP MAC addresses moved during map assignment
response_map_import_ap_action
string
enum: assigned-named-placed, assigned-placed, ignored, named-placed, placed
response_set_devices_map
object
Result of assigning APs to a site map
2 properties
map_sitesurvey_path_items
object
Site survey path definition on a map
4 properties
map_micello_vendor_name
string
The vendor ‘micello’. enum: micello
map_jibestream
object
Jibestream map import configuration
9 properties 9 required
created_time
number
When the object has been created, in epoch
map_geofence_vertices
array
List of vertices defining the geofence
response_map_import_ap
object
AP placement result from a map import
7 properties 5 required
response_map_import_aps
array
AP placement results produced by the map import
map_wayfinding_micello
object
Micello wayfinding integration settings
3 properties
map_wayfinding_path_nodes
array
Map nodes included in a wayfinding path
map_wall_path
object
JSON blob for wall definition (same format as wayfindingpath)
2 properties
map_geofence
object
Geofence drawn on a map
2 properties
map_node
object
Node in a map path graph
3 properties 1 required
map_sitesurvey_path
array
Site survey path definitions for a map
map_geofence_vertice
object
Vertex coordinate for a map geofence polygon
2 properties
response_set_devices_map_locked
array
AP MAC addresses that were locked during map assignment
map_site_replace_file
object
Multipart payload for replacing a site map image
2 properties 1 required
response_http401
object
Standard HTTP 401 authentication error response
1 property
response_http429
object
Standard HTTP 429 rate limit error response
1 property
id
string
Unique ID of the object instance in the Mist Organization
map_geofences
array
List of geofences for the map
map_site_replace_file_json_transform
object
If transform is provided, all the locations of the objects on the map (AP, Zone, Vbeacon, Beacon) will be transformed as well (relative to the new Map)
4 properties
map_wayfinding
object
Properties related to wayfinding
2 properties
map_wall_path_nodes
array
Map nodes included in a wall path
map_sitesurvey_path_items_nodes
array
Map nodes included in a site survey path
map_jibestream_vendor_name
string
The vendor ‘jibestream’. enum: jibestream
mac_addresses
object
Request containing one or more MAC addresses
1 property 1 required
map_import_json
object
Options for importing map data from Ekahau or iBwave JSON
4 properties 1 required
response_http400
object
Standard HTTP 400 bad request error response
1 property
response_map_import
object
Result of importing map files and matching AP placements
5 properties 4 required
wayfinding_import_json
Vendor wayfinding map metadata imported from Jibestream or Micello
map_view
stringnull
if type==google. enum: hybrid, roadmap, satellite, terrain
map_site_import_file
object
Multipart payload for importing map files at site scope
4 properties
modified_time
number
When the object has been modified for the last time, in epoch
response_http404
object
Standard HTTP 404 not found error response
1 property
map_site_replace_file_json
object
Options for replacing a site map image
1 property
response_map_import_floorplan
object
Floorplan result from a map import
5 properties 4 required
site_id
string
Unique identifier of a Mist site
image_import
object
Multipart image upload payload
2 properties 1 required
response_map_import_floorplans
array
Floorplan import results produced by the map import
map_import_json_vendor_name
string
Map import vendor for the uploaded JSON. enum: ekahau, ibwave
latlng_tl
object
When type==google, latitude and longitude of the top-left corner
2 properties
latlng_br
object
When type==google, latitude and longitude of the bottom-right corner
2 properties
map_node_position
object
Position of a map path node
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mist-sites-maps-api-openapi.yml Raw ↑

Other APIs Mist publishes across the network.

Mist Admins API
Mist Admins Login API
Mist Admins Login - OAuth2 API
Mist Admins Logout API
Mist Admins Lookup API
Mist Admins Recover Password API
Mist Constants Definitions API
Mist Constants Events API
Mist Constants Models API
Mist Installer API
Mist MSPs Admins API
Mist MSPs API
Where this information came from

This is an independent, third-party profile of Mist Sites Maps API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.