Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
MspsOrgs

getMspOrg

GET
/api/v1/msps/{msp_id}/orgs/{org_id}

Return details for one organization managed by this MSP, including MSP ownership, organization groups, support access, and session settings.

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

msp_id*string
Formatuuid
org_id*string
Formatuuid

Response Body

curl -X GET "https://example.com/api/v1/msps/000000ab-00ab-00ab-00ab-0000000000ab/orgs/000000ab-00ab-00ab-00ab-0000000000ab"
{  "alarmtemplate_id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "allow_mist": true,  "created_time": 0,  "id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "modified_time": 0,  "msp_id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "name": "string",  "orggroup_ids": [    "b069b358-4c97-5319-1f8c-7c5ca64d6ab1"  ],  "session_expiry": 1440}

manageMspOrgs PUT

Assign existing organizations to this MSP account or unassign organizations from it by providing the desired operation and org IDs.

deleteMspOrg DELETE

Delete an organization managed by this MSP. Use the MSP organization assignment endpoint when only assigning or unassigning organizations from the MSP account.