{ "opencollection": "1.0.0", "info": { "name": "Mist Admins Orgs Sites API", "version": "2606.1.1" }, "request": { "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "items": [ { "info": { "name": "Orgs Sites", "type": "folder" }, "items": [ { "info": { "name": "listOrgSites", "type": "http" }, "http": { "method": "GET", "url": "https://api.mist.com/api/v1/orgs/:org_id/sites", "params": [ { "name": "org_id", "value": "", "type": "path" }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of results to return per page" }, { "name": "page", "value": "", "type": "query", "description": "Select the page number to return when using page-based pagination; starts at `1`" } ] }, "docs": "List sites in the organization. Site records include location metadata, timezone, site group membership, and template or policy associations." }, { "info": { "name": "createOrgSite", "type": "http" }, "http": { "method": "POST", "url": "https://api.mist.com/api/v1/orgs/:org_id/sites", "params": [ { "name": "org_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a site in the organization with location metadata, timezone, site group membership, and optional template or policy associations." }, { "info": { "name": "countOrgSites", "type": "http" }, "http": { "method": "GET", "url": "https://api.mist.com/api/v1/orgs/:org_id/sites/count", "params": [ { "name": "org_id", "value": "", "type": "path" }, { "name": "distinct", "value": "", "type": "query", "description": "Field used to group this count response. enum: `analytic_enabled`, `app_waking`, `asset_enabled`, `auto_upgrade_enabled`, `auto_upgrade_version`, `country_code`, `honeypot_enabled`, `id`, `locate_unconnected`, `mesh_enabled`, `name`, `remote_syslog_enabled`, `rogue_enabled`, `rtsa_enabled`, `vna_enabled`, `wifi_enabled`" }, { "name": "start", "value": "", "type": "query", "description": "Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`" }, { "name": "end", "value": "", "type": "query", "description": "Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`" }, { "name": "duration", "value": "", "type": "query", "description": "Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`" }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of results to return per page" } ] }, "docs": "Count organization sites grouped by a distinct site attribute, such as country code, site name, feature flags, or enabled services." }, { "info": { "name": "searchOrgSites", "type": "http" }, "http": { "method": "GET", "url": "https://api.mist.com/api/v1/orgs/:org_id/sites/search", "params": [ { "name": "org_id", "value": "", "type": "path" }, { "name": "analytic_enabled", "value": "", "type": "query", "description": "If Advanced Analytic feature is enabled. Accepts multiple comma-separated boolean values." }, { "name": "app_waking", "value": "", "type": "query", "description": "If App Waking feature is enabled" }, { "name": "asset_enabled", "value": "", "type": "query", "description": "If Asset Tracking is enabled. Accepts multiple comma-separated boolean values." }, { "name": "auto_upgrade_enabled", "value": "", "type": "query", "description": "Filter results by whether automatic upgrades are enabled" }, { "name": "auto_upgrade_version", "value": "", "type": "query", "description": "Filter results by automatic upgrade version. Accepts multiple comma-separated values." }, { "name": "country_code", "value": "", "type": "query", "description": "Filter results by country code. Accepts multiple comma-separated values." }, { "name": "honeypot_enabled", "value": "", "type": "query", "description": "If Honeypot detection is enabled. Accepts multiple comma-separated boolean values." }, { "name": "id", "value": "", "type": "query", "description": "Filter results by identifier. Accepts multiple comma-separated values." }, { "name": "locate_unconnected", "value": "", "type": "query", "description": "If unconnected client are located. Accepts multiple comma-separated boolean values." }, { "name": "mesh_enabled", "value": "", "type": "query", "description": "If Mesh feature is enabled. Accepts multiple comma-separated boolean values." }, { "name": "name", "value": "", "type": "query", "description": "Partial / full Site name. Case insensitive. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-site*` and `*site*` match `my-site-01`). Suffix-only wildcards (e.g. `*site-01`) are not supported. Accepts multiple comma-separated values." }, { "name": "rogue_enabled", "value": "", "type": "query", "description": "If Rogue detection is enabled. Accepts multiple comma-separated boolean values." }, { "name": "remote_syslog_enabled", "value": "", "type": "query", "description": "If Remote Syslog is enabled" }, { "name": "rtsa_enabled", "value": "", "type": "query", "description": "If managed mobility feature is enabled. Accepts multiple comma-separated boolean values." }, { "name": "vna_enabled", "value": "", "type": "query", "description": "If Virtual Network Assistant is enabled. Accepts multiple comma-separated boolean values." }, { "name": "wifi_enabled", "value": "", "type": "query", "description": "If Wi-Fi feature is enabled" }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of results to return per page" }, { "name": "start", "value": "", "type": "query", "description": "Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`" }, { "name": "end", "value": "", "type": "query", "description": "Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`" }, { "name": "duration", "value": "", "type": "query", "description": "Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`" }, { "name": "sort", "value": "", "type": "query", "description": "On which field the list should be sorted, -prefix represents DESC order" }, { "name": "search_after", "value": "", "type": "query", "description": "Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed." } ] }, "docs": "Search organization sites with filters for feature flags, country code, identifiers, names, upgrade settings, and other site attributes. Supports pagination and sorting." } ] } ], "bundled": true }