{
  "opencollection": "1.0.0",
  "info": {
    "name": "Mist Admins Orgs NAC Portals API",
    "version": "2606.1.1"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Orgs NAC Portals",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "listOrgNacPortals",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals",
            "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 NAC portal configurations in the organization for guest portal, guest admin, or Marvis Client onboarding workflows."
        },
        {
          "info": {
            "name": "createOrgNacPortal",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a NAC portal configuration for guest access, guest administration, or Marvis Client certificate onboarding."
        },
        {
          "info": {
            "name": "getOrgNacPortal",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieve configuration details for a specific NAC portal, including portal type, SSID, SSO, guest portal, certificate, and template settings."
        },
        {
          "info": {
            "name": "updateOrgNacPortal",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update a NAC portal configuration, including portal type, SSID, SSO, guest portal, certificate, and template settings."
        },
        {
          "info": {
            "name": "deleteOrgNacPortal",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Delete an organization NAC portal configuration by NAC portal ID."
        },
        {
          "info": {
            "name": "listOrgNacPortalSsoLatestFailures",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id/failures",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              },
              {
                "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"
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Select the page number to return when using page-based pagination; starts at `1`"
              }
            ]
          },
          "docs": "List recent SAML SSO failures for a NAC portal within a selected time range."
        },
        {
          "info": {
            "name": "uploadOrgNacPortalImage",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id/portal_image",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "multipart-form",
              "data": []
            }
          },
          "docs": "Upload a custom background image for a NAC portal."
        },
        {
          "info": {
            "name": "deleteOrgNacPortalImage",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id/portal_image",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Delete the custom background image for a NAC portal. If no image is configured, the NAC portal uses the default background image."
        },
        {
          "info": {
            "name": "updateOrgNacPortalTemplate",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id/portal_template",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update visual template settings for a NAC portal, including alignment, primary color, logo, and Powered by visibility."
        },
        {
          "info": {
            "name": "getOrgNacPortalSamlMetadata",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id/saml_metadata",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieve SAML service provider metadata for a NAC portal, including ACS URL, entity ID, logout URL, and metadata XML."
        },
        {
          "info": {
            "name": "downloadOrgNacPortalSamlMetadata",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/orgs/:org_id/nacportals/:nacportal_id/saml_metadata.xml",
            "params": [
              {
                "name": "org_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "nacportal_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Download NAC portal SAML service provider metadata as an XML document.\n\nExample of metadata.xml:\n```xml\n<?xml version=\"1.0\" encoding=\"UTF-8\"?><md:EntityDescriptor xmlns:md=\"urn:oasis:names:tc:SAML:2.0:metadata\" entityID=\"https://api.mist.com/api/v1/saml/5hdF5g/login\" validUntil=\"2027-10-12T21:59:01Z\" xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\">\n    <md:SPSSODescriptor AuthnRequestsSigned=\"false\" WantAssertionsSigned=\"true\" protocolSupportEnumeration=\"urn:oasis:names:tc:SAML:2.0:protocol\">\n    "
        }
      ]
    }
  ],
  "bundled": true
}