OrgsIntegration SkyATP

setupOrgAtpIntegration

POST
/api/v1/orgs/{org_id}/setting/skyatp/setup

Configure the Sky ATP integration by linking or creating the Sky ATP realm with the supplied cloud, realm, username, and password. The integration enables Security Intelligence and Advanced Anti-Malware features, with SecIntel configuration for command-and-control, DNS feeds, infected hosts, blocklists, and allowlists.

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

Request Body

application/json

Sky ATP account credentials and realm settings used for integration

cloud_name?account_skyatp_cloud_name

Sky ATP cloud endpoint used for the integration. enum: www.amerskyatp.com, www.apacskyatp.com, www.euroskyatp.com, www.canadaskyatp.com.

Value in

  • "www.amerskyatp.com"
  • "www.apacskyatp.com"
  • "www.euroskyatp.com"
  • "www.canadaskyatp.com"
password*string

Credential password for the Sky ATP realm user

Formatpassword
realm*string

Sky ATP realm to create or link with this Mist organization

username*string

Sky ATP username used to create or access the realm

Response Body

curl -X POST "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/setting/skyatp/setup" \  -H "Content-Type: application/json" \  -d '{    "cloud_name": "www.amerskyatp.com",    "password": "foryoureyesonly",    "realm": "mist-team",    "username": "john@abc.com"  }'
{  "Example": {    "value": {      "secintel": {        "third_party_threat_feeds": [          "block_list"        ]      },      "secintel_allowlist_url": "https://papi.s3.amazonaws.com/secintel_allowlist/xxx...",      "secintel_blocklist_url": "https://papi.s3.amazonaws.com/secintel_blocklist/xxx..."    }  }}