Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
OrgsLinked Applications

getOrgOauthAppAuthorizationUrl

GET
/api/v1/orgs/{org_id}/setting/{app_name}/link_accounts

Return linked-account status for the specified organization OAuth application and the authorization URL used to start account linking.

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
app_name*string

OAuth application name

Value in

  • "crowdstrike"
  • "intune"
  • "jamf"
  • "mobicontrol"
  • "prisma"
  • "sentinelone"
  • "teams"
  • "vmware"
  • "zdx"
  • "zoom"

Query Parameters

forward*string

Mist portal url to which backend needs to redirect after successful OAuth authorization. Required to get the authorization_url

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/setting/crowdstrike/link_accounts?forward=string"

{  "accounts": [    {      "account_id": "ae9dee49-69e7-4710-a114-5b827a777738",      "last_status": "success",      "last_sync": 1665465339000,      "linked_by": "Testname1",      "linked_timestamp": 1728275689.284758,      "name": "Test Company1 Ltd"    },    {      "account_id": "845a23bf-bed9-e43c-4c86-6fa474be7ae5",      "error": "Get token failed, please re-link crowdstrike",      "last_status": "failed",      "last_sync": 1234567890123,      "linked_by": "Testname2",      "linked_timestamp": 1728275689.284758,      "name": "Test Company2 Ltd"    }  ],  "linked": true}

moveOrDeleteOrgLicenseToAnotherOrg PUT

Move, Undo Move or Delete Org License to Another Org If the admin has admin privilege against the `org_id` and `dst_org_id`, he can move some of the licenses to another Org. Given that: 1. the specified license is currently active 2. there’s enough licenses left in the specified license (by subscription_id) 3. there will still be enough entitled licenses for the type of license after the amendment

addOrgOauthAppAccounts POST

Add a linked account for the specified OAuth application using the app-specific account configuration payload.