Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
OrgsMxClusters

listOrgMxEdgeClusters

GET
/api/v1/orgs/{org_id}/mxclusters

List Mist Edge clusters in the organization, which group one or more Mist Edge devices for tunneling, RadSec, and related edge services.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

org_id*string
Formatuuid

Query Parameters

limit?integer

Maximum number of results to return per page

Range0 <= value
Default100
page?integer

Select the page number to return when using page-based pagination; starts at 1

Range1 <= value
Default1

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/mxclusters"
[  {    "created_time": 0,    "for_site": true,    "id": "467f6eca-6276-4993-bfeb-53cbbbba6f78",    "modified_time": 0,    "name": "string",    "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",    "radsec": {      "acct_servers": [        {          "host": "string",          "port": 1813,          "secret": "string"        }      ],      "auth_servers": [        {          "host": "string",          "port": 1812,          "secret": "string"        }      ],      "enabled": true,      "server_selection": "ordered"    },    "radsec_tls": {      "keypair": "string"    },    "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811",    "tunterm_ap_subnets": [      "string"    ],    "tunterm_dhcpd_config": {      "enabled": false,      "property1": {        "enabled": false,        "servers": [          "string"        ],        "type": "relay"      },      "property2": {        "enabled": false,        "servers": [          "string"        ],        "type": "relay"      },      "servers": [        "string"      ],      "type": "relay"    },    "tunterm_extra_routes": {      "property1": {        "via": "string"      },      "property2": {        "via": "string"      }    },    "tunterm_hosts": [      "string"    ]  }]

updateOrgMarvisClientInvite PUT

Update a Marvis Client onboarding invite profile, including enabled telemetry, location, and synthetic-test capabilities.

createOrgMxEdgeCluster POST

Create a Mist Edge cluster with tunnel termination, RadSec, NAC, and management settings. **Note**: It is not recommended to combine multiple roles (tunnel termination, RadSec, NAC) on the same Mist Edge cluster