{
  "opencollection": "1.0.0",
  "info": {
    "name": "Mist Admins Orgs Guests API",
    "version": "2606.1.1"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Orgs Guests",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "listOrgGuestAuthorizations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/guests",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "List guest authorization records across the organization, including WLAN, SSID, authentication method, expiration, and guest identity details."
        },
        {
          "info": {
            "name": "countOrgGuestAuthorizations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/guests/count",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "distinct",
                "value": "",
                "type": "query",
                "description": "Field used to group this count response. enum: `auth_method`, `company`, `ssid`"
              },
              {
                "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 guest authorization records, optionally grouped by `distinct` and filtered by time range."
        },
        {
          "info": {
            "name": "searchOrgGuestAuthorization",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/guests/search",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "wlan_id",
                "value": "",
                "type": "query",
                "description": "Filter results by WLAN identifier"
              },
              {
                "name": "auth_method",
                "value": "",
                "type": "query",
                "description": "Filter results by authentication method"
              },
              {
                "name": "ssid",
                "value": "",
                "type": "query",
                "description": "Filter results by SSID"
              },
              {
                "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"
              }
            ]
          },
          "docs": "Search organization guest authorization records with filters for WLAN, SSID, authentication method, and time range."
        },
        {
          "info": {
            "name": "getOrgGuestAuthorization",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/guests/:guest_mac",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "guest_mac",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieve the guest authorization record associated with a guest MAC address."
        },
        {
          "info": {
            "name": "updateOrgGuestAuthorization",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/guests/:guest_mac",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "guest_mac",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update the organization guest authorization record for a guest MAC address, including authorization state, duration, WLAN, and guest identity fields."
        },
        {
          "info": {
            "name": "deleteOrgGuestAuthorization",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/guests/:guest_mac",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "guest_mac",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Delete a guest authorization record by guest MAC address."
        }
      ]
    }
  ],
  "bundled": true
}