SentinelOne Singularity XDRプラグイン（リスクエクスチェンジ用）

使うAPI一覧

APIエンドポイント	方法	使うケース
/web/api/v2.1/sites	得る	プラットフォームの接続状況を確認し、サイト名を検証してください。
/web/api/v2.1/xdr/assets/surface/endpoint	得る	プラットフォームからデバイスを取り外します。
/web/api/v2.1/xdr/assets/surface/identity	得る	プラットフォームからユーザーを引き離す。
/web/api/v2.1/application-management/risks/applications	得る	脆弱性やリスクのあるアプリケーションを取得します。
/web/api/v2.1/application-management/risks	得る	リスクとアプリケーションの脆弱性を把握する。
/web/api/v2.1/groups	得る	静的グループと固定グループをすべて一覧表示します。
/web/api/v2.1/groups	役職	静的グループまたは固定グループを作成します。
/ウェブ/api/v2.1/groups/<group_id>/move-agents	PUT	エンドポイントデバイスをグループに移動します。
/web/api/v2.1/agents/tags	得る	Fetch all tags.
/web/api/v2.1/tag-manager	役職	デバイス用の新しいタグを作成します。
/web/api/v2.1/agents/actions/manage-tags	役職	デバイスにタグを追加します。
/web/api/v2.1/agents/actions/manage-tags	役職	デバイスからタグを取り外します。
/web/api/v2.1/agents/actions/disconnect	役職	デバイスをネットワークから切断します。（分離）
/web/api/v2.1/agents/actions/connect	役職	デバイスをネットワークに再接続してください。（分離解除）
/web/api/v2.1/xdr/assets/action	役職	資産の重要度を更新する。
/web/api/v2.1/agents/actions/initiate-scan	役職	デバイスのディスク全体スキャンを開始します。
/web/api/v2.1/application-management/scan	役職	デバイス上でアプリケーションの脆弱性スキャンを開始します。
/web/api/v2.1/agents/actions/restart-machine	役職	デバイスを再起動してください。

接続チェック

API Endpoint: GET /web/api/v2.1/sites

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query Parameters

鍵	Value	デスクリプション
sortBy	name	並べ替えフィールド
sortOrder	asc	並べ替え順序
limit	1000	Max value 1000
cursor	<next_page_cursor>	前回の要求によって返されたカーソル位置。1000 項目以上を反復処理するのに時間がかかります。

Sample Response

{
    "data": {
        "allSites": {
            "activeLicenses": 0,
            "totalLicenses": 0
        },
        "sites": [
            {
                "accountId": "1268419425097944269",
                "accountName": "Netskope",
                "activeLicenses": 6,
                "createdAt": "2026-03-18T09:43:40.831461Z",
                "creator": "netskope",
                "creatorId": "2413779193746265055",
                "description": null,
                "expiration": null,
                "externalId": null,
                "healthStatus": true,
                "id": "2437714560078484067",
                "inheritAccountExpiration": false,
                "irFields": null,
                "isDefault": false,
                "licenses": {
                    "bundles": [
                        {
                            "displayName": "Endpoint Security - Complete",
                            "majorVersion": 1,
                            "minorVersion": 33,
                            "name": "complete",
                            "surfaces": [
                                {
                                    "count": -1,
                                    "name": "Total Agents"
                                }
                            ],
                            "totalSurfaces": -1
                        },
                        {
                            "displayName": "CNS Pro",
                            "majorVersion": 1,
                            "minorVersion": 19,
                            "name": "cloud_native_security_pro",
                            "surfaces": [
                                {
                                    "count": -1,
                                    "name": "Workloads"
                                }
                            ],
                            "totalSurfaces": -1
                        },
                        {
                            "displayName": "Data Ingest",
                            "majorVersion": 1,
                            "minorVersion": 9,
                            "name": "singularity_data_lake",
                            "surfaces": [
                                {
                                    "count": 1,
                                    "name": "Average GB/Day"
                                },
                                {
                                    "count": 0,
                                    "name": "Long-Range Query Credits"
                                }
                            ],
                            "totalSurfaces": 1
                        },
                        {
                            "displayName": "Hyperautomation",
                            "majorVersion": 1,
                            "minorVersion": 4,
                            "name": "hyperautomation",
                            "surfaces": [
                                {
                                    "count": -1,
                                    "name": "Action Packs"
                                }
                            ],
                            "totalSurfaces": -1
                        },
                        {
                            "displayName": "Identity Detection & Response (IDR)",
                            "majorVersion": 2,
                            "minorVersion": 4,
                            "name": "singularity_identity",
                            "surfaces": [
                                {
                                    "count": -1,
                                    "name": "Total Endpoints"
                                }
                            ],
                            "totalSurfaces": -1
                        }
                    ],
                    "modules": [
                        {
                            "displayName": "Remote Script Orchestration",
                            "majorVersion": 1,
                            "name": "rso"
                        },
                        {
                            "displayName": "RemoteOps Forensics",
                            "majorVersion": 1,
                            "name": "remote_ops_forensics"
                        },
                        {
                            "displayName": "Binary Vault - Benign Files",
                            "majorVersion": 1,
                            "name": "binary_vault_benign"
                        },
                        {
                            "displayName": "Cloud Funnel",
                            "majorVersion": 1,
                            "name": "cloud_funnel"
                        },
                        {
                            "displayName": "Vulnerability Management",
                            "majorVersion": 1,
                            "name": "vulnerability_management"
                        },
                        {
                            "displayName": "Purple AI SOC Analyst",
                            "majorVersion": 1,
                            "name": "purple_ai_soc_analyst"
                        }
                    ],
                    "settings": [
                        {
                            "displayName": "Enabled",
                            "groupName": "remote_shell_availability",
                            "setting": "Enabled",
                            "settingGroup": "remote_shell_availability",
                            "settingGroupDisplayName": "Remote Shell"
                        },
                        {
                            "displayName": "365 Days",
                            "groupName": "malicious_data_retention",
                            "setting": "365 Days",
                            "settingGroup": "malicious_data_retention",
                            "settingGroupDisplayName": "Malicious Data Retention"
                        },
                        {
                            "displayName": "Available",
                            "groupName": "marketplace_access_status",
                            "setting": "Available",
                            "settingGroup": "marketplace_access_status",
                            "settingGroupDisplayName": "Marketplace Access"
                        },
                        {
                            "displayName": "14 Days",
                            "groupName": "dv_retention",
                            "setting": "14 Days",
                            "settingGroup": "dv_retention",
                            "settingGroupDisplayName": "Deep Visibility Data Retention"
                        }
                    ]
                },
                "name": "CRE Singularity",
                "registrationToken": "eyJ1cmwiOiAiaHR0cHM6Ly911wYXJ0bmVycy5zZW50aW5lbG9uZS5uZXQiLCAic2IzZTRlNTRjZDAwYTkyYjljNGQ4NDdjMmMxODU0N2Q1YzRiNTUwZGM4YTRhODY1MDhjMiJ9",
                "siteType": "Trial",
                "sku": "Complete",
                "state": "active",
                "suite": "Complete",
                "totalLicenses": 0,
                "unlimitedExpiration": true,
                "unlimitedLicenses": true,
                "updatedAt": "2026-03-23T09:54:29.950520Z",
                "usageType": null
            }
        ]
    },
    "pagination": {
        "nextCursor": null,
        "totalItems": 7
    }
}

プルデバイス（エンドポイント）

API Endpoint: GET /ウェブ/api/v2.1/xdr/assets/surface/エンドポイント

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query parameters:

パラメータ	Value	デスクリプション
siteIds	<site_id>	設定されたサイト名から解決されたサイトID
limit	1000	Max records per page
cursor	<next_page_cursor>	Pagination cursor
skipCount	true	スピード重視で合計カウントをスキップ

Sample Response

{
    "data": [
        {
            "activeCoverage": [
                "EPP",
                "IDR"
            ],
            "adsEnabled": false,
            "agent": {
                "agentVersion": "25.2.5.437",
                "antiTamperingStatus": "Enabled",
                "configurableNetworkQuarantine": false,
                "consoleConnectivity": false,
                "consoleMigrationStatus": "N/A",
                "customerIdentifier": "",
                "decommissioned": false,
                "detectionState": "install_to_dynamic",
                "diskEncryption": true,
                "dvConnectivity": "",
                "dvConnectivityLastUpdatedDt": "2026-03-23T19:21:24.46841Z",
                "firewallStatus": true,
                "hasLocalConfig": false,
                "id": "2441356020949988360",
                "installerType": ".msi",
                "lastLoggedInUser": "Crest",
                "lastReportedIp": "192.168.17.205",
                "location": [],
                "missingPermissions": [],
                "networkStatus": "connected",
                "operationalState": "na",
                "pendingActions": [],
                "pendingUninstall": false,
                "pendingUpgrade": false,
                "rangerStatus": "Enabled",
                "rangerVersion": "21.11.0.171",
                "remoteProfilingState": "disabled",
                "scanStartedTimeDt": "2026-03-23T10:18:50.535573Z",
                "scanStatus": "started",
                "subscribeOnDt": "2026-03-23T10:18:36.790704Z",
                "uninstalled": false,
                "upToDate": true,
                "uuid": "df0db53f4bc14b9d89c023494c0c7f4d",
                "vssProtectionStatus": "",
                "vssRollbackStatus": "",
                "vssServiceStatus": ""
            },
            "id": "qrrw3vjwit2vrtjc6sqtle3jra"
        }
    ]
}

プルユーザー（ID）

API Endpoint: GET /ウェブ/api/v2.1/xdr/assets/surface/identity

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query parameters

鍵	Value	デスクリプション
siteIds	site_id	SentinelOneサイトID。サイト名設定パラメータから取得します。
limit	1000	Max Value 1000
cursor	<next_page_cursor>	前回の要求によって返されたカーソル位置。1000 項目以上を反復処理するのに時間がかかります。
skipCount	true	もしこれが真実であれば、アイテムの総数は計算されないため、実行時間が短縮されます。
resourceType	ADユーザー

Sample Response

{
    "data": [
        {
            "accountExpires": "1970-01-01T00:00:00Z",
            "activeCoverage": [
                "ISPM"
            ],
            "adminCount": 0,
            "assetContactEmail": "",
            "assetCriticality": "",
            "assetEnvironment": "Active Directory",
            "assetStatus": "Active",
            "badPasswordCount": 0,
            "badPasswordTime": "1970-01-01T00:00:00Z",
            "category": "Identity",
            "cn": "netskopeuser",
            "createdTime": "2026-02-04T09:13:05Z",
            "deleted": false,
            "displayName": "netskopeuser",
            "distinguishedName": "CN=netskopeuser,CN=Users,DC=ec,DC=local",
            "domain": "ec.local",
            "enabled": true,
            "forest": "ec.local",
            "id": "dpdcguxhdecy3nnhq4aquqzxsa",
            "idSecondary": [
                "RANGER_AD:19488:S1TNT=ba0iSIleFakuSPme:8f4efa15-c7db-4946-ae1a-ea1cdbf7402a",
                "RANGER_AD:19488:8f4efa15-c7db-4946-ae1a-ea1cdbf7402a"
            ],
            "infectionStatus": "Healthy",
            "lastLogonTime": "2026-03-16T11:07:33Z",
            "lastModifiedTime": "2026-04-02T06:45:23Z",
            "lockOutTime": "1970-01-01T00:00:00Z",
            "logonCount": 15,
            "memberOf": [
                "Remote Desktop Users"
            ],
            "missingCoverage": [],
            "name": "netskopeuser",
            "notes": [
                {
                    "createdAt": "2026-04-05T07:45:32.089694Z",
                    "id": "fc7d1e8a-434e-4584-9977-ba9780882e78",
                    "note": "<div data-rich-text-editor-signature><p class=\"rich-text-editor_paragraph__Xhp0C\">This user is for client status data generation on Netskope tenant.</p></div>",
                    "updatedAt": "2026-04-05T07:45:32.089704Z",
                    "userId": "2413779193746265055",
                    "userName": "ashukla@netskope.com"
                }
            ],
            "objectCategory": "Person",
            "objectClass": [
                "top",
                "person",
                "organizationalPerson",
                "user"
            ],
            "objectGuid": "8f4efa15-c7db-4946-ae1a-ea1cdbf7402a",
            "objectSid": "S-1-5-21-1076376550-343107771-3680882144-1104",
            "parentDistName": "CN=Users,DC=ec,DC=local",
            "passwordLastSetTime": "2026-02-04T09:13:05Z",
            "passwordNeverExpire": true,
            "primaryGroupId": 513,
            "principalName": "EC\\netskopeuser",
            "privileged": false,
            "recycled": false,
            "resourceType": "AD User",
            "riskFactors": [],
            "s1AccountId": "1268419425097944269",
            "s1AccountName": "Netskope",
            "s1ManagementId": 19488,
            "s1ScopeId": "2437714560078484067",
            "s1ScopeLevel": "site",
            "s1ScopePath": "Netskope/CRE Singularity",
            "s1ScopeType": 1,
            "s1SiteId": "2437714560078484067",
            "s1SiteName": "CRE Singularity",
            "s1UpdatedAt": "2026-04-05T07:48:30Z",
            "samAccountName": "netskopeuser",
            "samAccountType": 805306368,
            "serviceAccount": false,
            "subCategory": "Users and Groups",
            "surfaces": [
                "Identity"
            ],
            "tags": [
                {
                    "applied_at": "2026-04-05T07:47:18.740705Z",
                    "applied_by_user_id": "2413779193746265055",
                    "id": "2450701933736065398",
                    "key": "User",
                    "key_value": "User:Tag1",
                    "read_only": false,
                    "reserved": false,
                    "source": "User",
                    "value": "Tag1"
                }
            ],
            "userAccountControl": 66048,
            "userPrincipalName": "netskopeuser@ec.local",
            "usnChanged": 32916,
            "usnCreated": 12841
        }
    ],
    "pagination": {
        "nextCursor": "eyJpZF9jb2x1bW4iOiAiTm9uZSIsICJpZF92YWx1ZSI6IG51bGwsICJpZF9zb3J0X29yZGVyIjogImFzYyIsICJzb3J0X2J5X2NvbHVtbiI6ICJOb25lIiwgInNvcnRfYnlfdmFsdWUiOiBbImNsb25lYWJsZSBkb21haW4gY29udHJvbGxlcnMiLCAiZGV1anhxNTJhcW9ybGR2cWxqMm96Y3ZjeWEiXSwgInNvcnRfb3JkZXIiOiAiYXNjIn0%3D",
        "totalItems": 56
    }
}

プルアプリケーション

Get Basic Application Details

API Endpoint: GET /ウェブ/api/v2.1/application-management/risks/applications

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query Parameters

鍵	Value	デスクリプション
siteIds	site_id	SentinelOneサイトID。サイト名設定パラメータから取得します。
limit	1000	Max Value 1000
cursor	<next_page_cursor>	前回の要求によって返されたカーソル位置。1000 項目以上を反復処理するのに時間がかかります。
skipCount	true	もしこれが真実であれば、アイテムの総数は計算されないため、実行時間が短縮されます。
sortBy	name	フィールドで並べ替え
sortOrder	asc	昇順
applicationType	応用

Sample Response

{
    "data": [
        {
            "applicationId": "2066008415608298271",
            "applicationType": "Application",
            "cveCount": 1,
            "daysDetected": 16,
            "detectionDate": "2026-03-20T09:55:13.780194Z",
            "endpointCount": 1,
            "endpointsWithoutTicket": 0,
            "estimate": false,
            "exploitCodeMaturity": null,
            "exploitedInTheWild": "Unknown",
            "highestNvdBaseScore": "4.70",
            "highestRiskScore": "2.60",
            "highestSeverity": "LOW",
            "name": "amd64-microcode 3.20191218.1ubuntu1.3",
            "remediationLevel": null,
            "statuses": [
                {
                    "count": 1,
                    "key": "NOT_MITIGATED",
                    "label": "Not mitigated",
                    "ticketCategory": null
                }
            ],
            "vendor": "Ubuntu Developers <ubuntu-devel-discuss@lists.ubuntu.com>"
        }
    ]
}

Pull Application Vulnerabilities

API Endpoint: GET /ウェブ/api/v2.1/application-management/risks

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query Parameters

鍵	Value	デスクリプション
siteIds	site_id	SentinelOneサイトID。サイト名設定パラメータから取得します。
limit	1000	Max Value 1000
cursor	<next_page_cursor>	前回の要求によって返されたカーソル位置。1000 項目以上を反復処理するのに時間がかかります。
skipCount	true	もしこれが真実であれば、アイテムの総数は計算されないため、実行時間が短縮されます。
sortBy	application	フィールドで並べ替え
sortOrder	asc	昇順

Sample Response

{
    "data": [
        {
            "application": "7-Zip 19.00",
            "applicationName": "7-Zip",
            "applicationVendor": "Igor Pavlov",
            "applicationVersion": "19.00",
            "cveId": "CVE-2025-11001",
            "cvssVersion": "3.1",
            "daysDetected": 20,
            "detectionDate": "2026-04-10T06:09:01.882869Z",
            "endpointId": "2441356020949988360",
            "endpointName": "clw699",
            "endpointType": "laptop",
            "exploitCodeMaturity": "Proof of Concept",
            "id": "2454276368152639000",
            "lastScanDate": "2026-04-15T10:24:22Z",
            "lastScanResult": "Succeeded",
            "markType": "",
            "markedBy": null,
            "markedDate": null,
            "mitigationStatus": "Not mitigated",
            "mitigationStatusChangeTime": null,
            "mitigationStatusChangedBy": null,
            "mitigationStatusReason": null,
            "nvdBaseScore": "7.80",
            "nvdCvssVersion": "3.1",
            "osType": "windows",
            "publishedDate": "2025-10-08T04:39:35Z",
            "reason": null,
            "remediationLevel": "Official Fix",
            "reportConfidence": "Confirmed",
            "riskScore": "5.70",
            "severity": "MEDIUM",
            "status": "Detected"
        }
    ],
    "pagination": {
        "nextCursor": "eyJpZF9jb2x1bW4iOiAiUmlza1ZpZXcuaWQiLCAiaWRfdmFsdWUiOiAyNDU0Mjc2MzY4MTUyNjM5MDAwLCAiaWRfc29ydF9vcmRlciI6ICJhc2MiLCAic29ydF9ieV9jb2x1bW4iOiAiUmlza1ZpZXcuZW5kcG9pbnRfbmFtZSIsICJzb3J0X2J5X3ZhbHVlIjogImNsdzY5OSIsICJzb3J0X29yZGVyIjogImFzYyJ9",
        "totalItems": 1570
    }
}

デバイスをグループに移動する

Get Groups

API エンドポイント: GET /web/api/v2.1/groups

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query Parameters

鍵	Value	デスクリプション
siteIds	site_id	SentinelOneサイトID。サイト名設定パラメータから取得します。
limit	300	Max Value 300
cursor	<next_page_cursor>	前回の要求によって返されたカーソル位置。1000 項目以上を反復処理するのに時間がかかります。
skipCount	true	もしこれが真実であれば、アイテムの総数は計算されないため、実行時間が短縮されます。
sortBy	name	フィールドで並べ替え
sortOrder	asc	昇順
types	静的、固定	アクション設定パラメータにリストするグループの種類。

回答例

{
    "data": [
        {
            "createdAt": "2026-04-02T13:54:36.500484Z",
            "creator": "Netskope",
            "creatorId": "2413779193746265055",
            "description": "Manual group created via API.",
            "filterId": null,
            "filterName": null,
            "id": "2448712492137993273",
            "inherits": true,
            "isDefault": false,
            "name": "API Group",
            "rank": null,
            "registrationToken": "eyJ1cmwiOiAiaHR0cHM6Ly91c2VhMS1wYXJ0bmVycy5zZW50aW5lbG9uZS5uZXQiLCAic2l0ZV9rZXkiOiAiZ18xZjAyYmQwYTlhYmM3YTZjNThmMmQyYjJiMWE3MzUwMDhiMTdkYTRjOTEzNzg5YzVjYzU2MGE1MzlhZTY4NmQ1In0=",
            "siteId": "2437714560078484067",
            "totalAgents": 0,
            "type": "static",
            "updatedAt": "2026-04-02T13:54:37.150255Z"
        }
    ],
    "pagination": {
        "nextCursor": "eyJpZF9jb2x1bW4iOiAiR3JvdXAuaWQiLCAiaWRfdmFsdWUiOiAyNDQ4NzEyNDkyMTM3OTkzMjczLCAiaWRfc29ydF9vcmRlciI6ICJhc2MiLCAic29ydF9ieV9jb2x1bW4iOiAiR3JvdXAubmFtZSIsICJzb3J0X2J5X3ZhbHVlIjogIkFQSSBHcm91cCIsICJzb3J0X29yZGVyIjogImFzYyJ9",
        "totalItems": 4
    }
}

Create Group

API エンドポイント: POST /web/api/v2.1/groups

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Request Body

{
    "data": {
        "name": "Group name",
        "description": "Group Created via Cloud Exchange",
        "inherits": "True",
        "siteId": "225494730938493804",
        "type": "static or pinned"
    }
}

Sample Response

{
    "data": {
        "createdAt": "2026-04-02T13:55:03.282857Z",
        "creator": "netskope",
        "creatorId": "2413779193746265055",
        "description": "Pinned group created via API.",
        "filterId": null,
        "id": "2448712716877190565",
        "isDefault": false,
        "name": "API Pinned Group",
        "rank": null,
        "registrationToken": "eyJ1cmwiOiAiaHR0cHM6Ly91c2VhMS1wYXJ0bmVycy5zZW50aW5lbG9uZS5uZXQiLCAic2l0ZV9rZXkiOiAiZ19iNDMyZmM4M2I1YjRmM2U0MTY1ZDM5ODQ0ZDVlMGY0YjZlNzdjNDlkZDM3MzI1NDA3ZmUxOWQ0ODg5Y2MyYmM5In0=",
        "siteId": "2437714560078484067",
        "type": "pinned",
        "updatedAt": "2026-04-02T13:55:05.443663Z"
    }
}

Move device to Group

API Endpoint: PUT /web/api/v2.1/groups/<group_id>/move-agents

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Path Parameters

鍵	Value	デスクリプション
group_id	<group_id>	エンドポイントを追加するグループのID。

Request Body

{
    "filter": {
        "agentIds": [
            "agent_id",
            "agent_id"
        ],
        "siteIds": [
            "2437714560078484067"
        ]
    }
}

デバイスタグの管理

Fetch All Tags

API Endpoint: GET /web/api/v2.1/agents/tags

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

Query parameters

鍵	Value	デスクリプション
siteIds	site_id	SentinelOneサイトID。サイト名設定パラメータから取得します。
limit	1000	Max Value 1000
cursor	<next_page_cursor>	前回の要求によって返されたカーソル位置。1000 項目以上を反復処理するのに時間がかかります。
skipCount	true	もしこれが真実であれば、アイテムの総数は計算されないため、実行時間が短縮されます。
sortBy	鍵	フィールドで並べ替え
sortOrder	asc	昇順
includeEndpointCounters	false
includeChildren	true	これにより、サイト内の子オブジェクトに属するタグが取得されます（特定のグループに属するタグ）

回答例

{
    "data": [
        {
            "allowEdit": true,
            "createdAt": "2026-04-03T06:55:54.754516Z",
            "createdBy": "netskope (netskope@netskope.com)",
            "description": "API test",
            "endpointsInCurrentScope": 0,
            "id": "2449226531386302599",
            "key": "Agent",
            "scopeId": "2437714560078484067",
            "scopeLevel": "site",
            "scopePath": "Global\\Netskope\\CRE Singularity",
            "totalEndpoints": 0,
            "type": "agents",
            "updatedAt": "2026-04-03T06:55:54.754526Z",
            "updatedBy": "netskope (netskope@netskope.com)",
            "value": "Tag1"
        }
    ],
    "pagination": {
        "nextCursor": "eyJpZF9jb2x1bW4iOiAiVGFnTWFuYWdlclZpZXcuaWQiLCAiaWRfdmFsdWUiOiAyNDQ5MjI2NTMxMzg2MzAyNTk5LCAiaWRfc29ydF9vcmRlciI6ICJhc2MiLCAic29ydF9ieV9jb2x1bW4iOiAiVGFnTWFuYWdlclZpZXcua2V5IiwgInNvcnRfYnlfdmFsdWUiOiAiQWdlbnQiLCAic29ydF9vcmRlciI6ICJhc2MifQ%3D%3D",
        "totalItems": 0
    }
}

Create Tag

API エンドポイント: POST /web/api/v2.1/tag-manager

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "data": {
        "key": "<tag_key>",
        "type": "agents",
        "value": "<tag_value>",
        "description": "Tag created from Cloud Exchange"
    },
    "filter": {
        "siteIds": [
            "<site_id>"
        ]
    }
}

回答例

{
    "data": {
        "createdAt": "2026-04-03T07:08:24.221290Z",
        "createdById": "2413779193746265055",
        "description": "API test",
        "id": "2449232818371190824",
        "key": "Agent1",
        "scopeId": "2437714560078484067",
        "scopeLevel": "site",
        "type": "agents",
        "updatedAt": "2026-04-03T07:08:24.221299Z",
        "updatedById": "2413779193746265055",
        "value": "Tag1"
    }
}

Add Tag to Device

API エンドポイント: POST /web/api/v2.1/agents/actions/manage-tags

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "data": [
        {
            "operation": "add",
            "tagId": "tag_id"
        }
    ],
    "filter": {
        "siteIds": [
            "site_id"
        ],
        "ids": [
            "agent_id1",
            "agent_id2"
        ]
    }
}

回答例

{
    "data": {
        "affected": 1
    }
}

Remove Tag from Device

API エンドポイント: POST /web/api/v2.1/agents/actions/manage-tags

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "data": [
        {
            "operation": "remove",
            "tagId": "tag_id"
        }
    ],
    "filter": {
        "siteIds": [
            "site_id"
        ],
        "ids": [
            "agent_id1",
            "agent_id2"
        ]
    }
}

回答例

{
    "data": {
        "affected": 1
    }
}

Isolate/Undo-Isolate

Isolate device(Disconnect from Network)

API エンドポイント: POST /web/api/v2.1/agents/actions/disconnect

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "filter": {
        "ids": [
            "agent_id1",
            "agent_id2"
        ],
        "siteIds": [
            "site_id"
        ]
    }
}

回答例

{
    "data": {
        "affected": 1
    }
}745

Undo-Isolate device(Reconnect to Network)

API エンドポイント: POST /web/api/v2.1/agents/actions/connect

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "filter": {
        "ids": [
            "agent_id1",
            "agent_id2"
        ],
        "siteIds": [
            "site_id"
        ]
    }
}

回答例

{
    "data": {
        "affected": 1
    }
}

資産の重要度を更新する

API エンドポイント: POST /web/api/v2.1/xdr/assets/action

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "actionName": "<action_value>",
    "id__in": [
        "<asset_id1>",
        "<asset_id2>"
    ]
}

許可されるアクションの値（<action_value>）
mark_asset_criticality_low
mark_asset_criticality_medium
mark_asset_criticality_high
mark_asset_criticality_critical
clear_asset_criticality

回答例

{
    "data": [
        {
            "message": "Mark Critical Value Criticality Started"
        }
    ]
}

スキャンを実行

Initiate Full Disk Scan 

API エンドポイント: POST /web/api/v2.1/agents/actions/initiate-scan

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "filter": {
        "ids": [
            "<agent_id>1",
            "<agent_id2>"
        ],
        "siteIds": [
            "site_id"
        ]
    }
}

Sample Response

{
    "data": {
        "affected": 1
    }
}

Initiate Application Vulnerability Scan 

API エンドポイント: POST /web/api/v2.1/agents/actions/initiate-scan

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "filter": {
        "siteIds": [
            "2437714560078484067"
        ],
        "agentIds": [
          "2448495699704074860"
        ]
    }
}

回答例

{
    "data": {
        "success": true
    }
}

デバイスを再起動してください

API エンドポイント: POST /web/api/v2.1/agents/actions/restart-machine

Headers

鍵	Value
Authorization	ApiToken <token>
ユーザーエージェント	netskope-ce-6.1.0-cre-sentinelone-singularity-xdr-v1.0.0

リクエストボディ

{
    "filter": {
        "siteIds": [
            "site_id"
        ],
        "ids": [
            "agent_id1",
            "agent_id2"
        ]
    }
}

回答例

{
    "data": {
        "affected": 1
    }
}