CyberSecurity Asset Management / Global AssetView Release 3.8.0.0 API

November 18, 2026

The EASM profile APIs now support two new configuration options. You can include assets from your VMDR map scan results in EASM discovery for the networks that you select, and exclude cloud-hosted assets from EASM lightweight scans.

Before understanding the API release highlights, learn more about the API server URL to be used in your API requests by referring to the Know Your Qualys API Server URL section. For this API Release Notes, <qualys_base_url> is mentioned in the sample API requests.

Enhancement

Include Assets from VMDR Map Scan through EASM Profile APIs

What Changed for You

You can now use the EASM profile APIs to include assets from your VMDR map scan results in EASM discovery.

The EASM profile APIs now support the includeMapScanIps and networkIdsForMapScan parameters. Use these parameters to add the assets discovered from VMDR map scans to your EASM inventory. For more information, refer to CSAM 3.8.0.0 Release Notes.

New Parameters
Parameter Mandatory/
Optional
Data Type Description
includeMapScanIps Optional Boolean Provide the value as true to include assets from VMDR map scan results in the EASM discovery, or false to exclude them.

The default value is false.

networkIdsForMapScan Optional Array of Long

Provide the IDs of the networks to use for VMDR map scan results.

To fetch the network IDs, use the List Networks API from VMDR APIs.

  • Only a user with the Manager role can use the EASM profile APIs to set or change the includeMapScanIps and networkIdsForMapScan parameters.
  • VMDR map scans must be configured and completed for the selected networks.

The following EASM profile APIs support the new parameters:

Updated API: Create EASM Profile API

New or Updated API Updated
API Endpoint /easm/v2/profile
Method POST
DTD or XSD changes Not Applicable

Use this API to create an EASM profile that includes assets from VMDR map scan results for the selected networks.

Sample: Create an EASM profile that includes VMDR map scan resultsSample: Create an EASM profile that includes VMDR map scan results

API Request

curl -X POST
'<qualys_base_url>/easm/v2/profile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
  "name": "Corporate_Netblocks",
  "includeSeeds": [
    {
      "seedType": "NETBLOCK",
      "seedValue": "xxx.x.x.x/xx",
      "enumerateSubsidiary": false,
      "horizontalEnumeration": false,
      "seedFilters": [],
      "verticalEnumeration": false,
      "seedFileName": null
    }
  ],
  "excludeSeeds": [],
  "active": true,
  "enableEASMScan": false,
  "includeVMAssets": false,
  "excludeCDNAssets": true,
  "excludeCloudAssets": true,
"includeMapScanIps": true,
"networkIdsForMapScan": [<network_id_1>, <network_id_2>],
  "defaultPurgeRuleFrequency": 3,
  "excludeDefamatoryDomain": true,
  "enableTyposquattedDomainGeneration": false,
  "enableDomainSecurity": false
}'

API Response

{
  "code": "201",
  "status": "SAVED",
  "date": "2026-11-02 10:08:53",
  "message": "Profile Created Successfully."
}

Updated API: Update EASM Profile Data API

New or Updated API Updated
API Endpoint /easm/v2/profile/{profileName}
Method PUT
DTD or XSD changes Not Applicable

Use this API to update the includeMapScanIps and networkIdsForMapScan parameters in an EASM profile using the PUT method.

Sample: Update an EASM profile using the PUT methodSample: Update an EASM profile using the PUT method

API Request

curl -X PUT
'<qualys_base_url>/easm/v2/profile/Corporate_Netblocks'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
  "name": "Corporate_Netblocks",
  "includeSeeds": [
    {
      "seedType": "NETBLOCK",
      "seedValue": "xxx.x.x.x/xx",
      "enumerateSubsidiary": false,
      "horizontalEnumeration": false,
      "seedFilters": [],
      "verticalEnumeration": false,
      "seedFileName": null
    }
  ],
  "excludeSeeds": [],
  "active": true,
  "enableEASMScan": false,
  "includeVMAssets": false,
  "excludeCDNAssets": true,
  "excludeCloudAssets": true,
 "includeMapScanIps": true,
 "networkIdsForMapScan": [<network_id_1>, <network_id_2>],
  "defaultPurgeRuleFrequency": 3,
  "excludeDefamatoryDomain": true,
  "enableTyposquattedDomainGeneration": false,
  "enableDomainSecurity": false
}'

API Response

{
  "code": "200",
  "status": "UPDATED",
  "date": "2026-11-02 10:59:08",
  "message": "Profile Updated Successfully"
}

Updated API: Patch EASM Profile Data API

New or Updated API Updated
API Endpoint /easm/v2/profile/{profileName}
Method PATCH
DTD or XSD changes Not Applicable

Use this API to update only the includeMapScanIps and networkIdsForMapScan parameters in an EASM profile using the PATCH method.

Sample: Update the networks for VMDR map scan results using the PATCH methodSample: Update the networks for VMDR map scan results using the PATCH method

API Request

curl -X PATCH
'<qualys_base_url>/easm/v2/profile/Corporate_Netblocks'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
  "includeMapScanIps": true,
  "networkIdsForMapScan": [<network_id_1>, <network_id_2>]
}'

API Response

{
  "code": "200",
  "status": "UPDATED",
  "date": "2026-11-02 10:59:08",
  "message": "Profile Updated Successfully"
}

Updated API: Get EASM Profile Data API

New or Updated API Updated
API Endpoint /easm/v2/profile
Method GET
DTD or XSD changes Not Applicable

Use this API to fetch EASM profile details, including the includeMapScanIps and networkIdsForMapScan parameters in the response.

Sample: Fetch the details of an EASM profileSample: Fetch the details of an EASM profile

API Request

curl -X GET
'<qualys_base_url>/easm/v2/profile?profileName=Corporate_Netblocks'
--header 'Authorization: Bearer <JWT Token>'

API Response

{
  "hasNextPage": false,
  "profile": [
    {
      "name": "Corporate_Netblocks",
      "includeSeeds": [
        {
          "seedType": "NETBLOCK",
          "seedValue": "192.0.2.0/24",
          "seedHeading": null,
          "enumerateSubsidiary": false,
          "horizontalEnumeration": false,
          "seedFilters": [],
          "verticalEnumeration": false,
          "seedFileName": null
        }
      ],
      "excludeSeeds": [],
      "active": true,
      "profileTagName": "Corporate_Netblocks",
      "enableEASMScan": false,
      "includeVMAssets": false,
      "excludeCDNAssets": true,
      "excludeCloudAssets": true,
      "includeMapScanIps": true,
      "networkIdsForMapScan": [<network_id_1>, <network_id_2>],
      "defaultPurgeRuleFrequency": 3,
      "excludeDefamatoryDomain": true,
      "enableTyposquattedDomainGeneration": false,
      "enableDomainSecurity": false,
      "easmScanAssetsScoping": null
    }
  ]
}

Enhancement

Exclude Cloud Assets from EASM Lightweight Scans through EASM Profile APIs

What Changed for You

You can now use the EASM profile APIs to exclude cloud-hosted assets from EASM lightweight scans. This helps focus scans on your organization's own internet-facing assets.

The EASM profile APIs now support the excludeCloudAssets parameter. When you set this parameter to true, EASM excludes cloud-hosted assets from EASM lightweight scans across all discovery sources. For more information, refer to CSAM 3.8.0.0 Release Notes.

New Parameter
Parameter Mandatory/
Optional
Data Type Description
excludeCloudAssets Optional Boolean Provide the value as true to exclude cloud-hosted assets from EASM lightweight scans, or false to include them. The default value is true.

You can set excludeCloudAssets to false only when the EASM scan is enabled for the profile by setting the enableEASMScan parameter to true.

The following EASM profile APIs support the new parameter:

By default, cloud and CDN assets are excluded from EASM lightweight scans. To include them by setting excludeCloudAssets or excludeCDNAssets to false, contact your Technical Account Manager (TAM) to enable this option for your account.

Updated API: Create EASM Profile API

New or Updated API Updated
API Endpoint /easm/v2/profile
Method POST
DTD or XSD changes Not Applicable

Use this API to create an EASM profile that excludes cloud-hosted assets from EASM lightweight scans.

Sample: Create an EASM profile that excludes cloud assets from EASM scansSample: Create an EASM profile that excludes cloud assets from EASM scans

API Request

curl -X POST
'<qualys_base_url>/easm/v2/profile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
  "name": "Corporate_Domains",
  "includeSeeds": [
    {
      "seedType": "DOMAIN",
      "seedValue": "example.com",
      "enumerateSubsidiary": false,
      "horizontalEnumeration": false,
      "seedFilters": [],
      "verticalEnumeration": false,
      "seedFileName": null
    }
  ],
  "excludeSeeds": [],
  "active": true,
  "enableEASMScan": true,
  "includeVMAssets": false,
  "excludeCDNAssets": true,
  "excludeCloudAssets": true,
  "includeMapScanIps": false,
  "networkIdsForMapScan": [],
  "defaultPurgeRuleFrequency": 3,
  "excludeDefamatoryDomain": true,
  "enableTyposquattedDomainGeneration": false,
  "enableDomainSecurity": false
}'

API Response

{
  "code": "201",
  "status": "SAVED",
  "date": "2026-11-02 10:08:53",
  "message": "Profile Created Successfully."
}

Updated API: Update EASM Profile Data API

New or Updated API Updated
API Endpoint /easm/v2/profile/{profileName}
Method PUT
DTD or XSD changes Not Applicable

Use this API to update the excludeCloudAssets parameter in an EASM profile using the PUT method.

Sample: Include cloud assets in EASM scans using the PUT methodSample: Include cloud assets in EASM scans using the PUT method

API Request

curl -X PUT
'<qualys_base_url>/easm/v2/profile/Corporate_Domains'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
  "name": "Corporate_Domains",
  "includeSeeds": [
    {
      "seedType": "DOMAIN",
      "seedValue": "example.com",
      "enumerateSubsidiary": false,
      "horizontalEnumeration": false,
      "seedFilters": [],
      "verticalEnumeration": false,
      "seedFileName": null
    }
  ],
  "excludeSeeds": [],
  "active": true,
  "enableEASMScan": true,
  "includeVMAssets": false,
  "excludeCDNAssets": true,
  "excludeCloudAssets": false,
  "includeMapScanIps": false,
  "networkIdsForMapScan": [],
  "defaultPurgeRuleFrequency": 3,
  "excludeDefamatoryDomain": true,
  "enableTyposquattedDomainGeneration": false,
  "enableDomainSecurity": false
}'

API Response

{
  "code": "200",
  "status": "UPDATED",
  "date": "2026-11-02 10:59:08",
  "message": "Profile Updated Successfully"
}

Updated API: Patch EASM Profile Data API

New or Updated API Updated
API Endpoint /easm/v2/profile/{profileName}
Method PATCH
DTD or XSD changes Not Applicable

Use this API to update only the excludeCloudAssets parameter in an EASM profile using the PATCH method.

Sample: Exclude cloud assets from EASM scans using the PATCH methodSample: Exclude cloud assets from EASM scans using the PATCH method

API Request

curl -X PATCH
'<qualys_base_url>/easm/v2/profile/Corporate_Domains'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
  "excludeCloudAssets": true
}'

API Response

{
  "code": "200",
  "status": "UPDATED",
  "date": "2026-11-02 10:59:08",
  "message": "Profile Updated Successfully"
}

Updated API: Get EASM Profile Data API

New or Updated API Updated
API Endpoint /easm/v2/profile
Method GET
DTD or XSD changes Not Applicable

Use this API to fetch EASM profile details, including the excludeCloudAssets parameter in the response.

Sample: Fetch the details of an EASM profileSample: Fetch the details of an EASM profile

API Request

curl -X GET
'<qualys_base_url>/easm/v2/profile?profileName=Corporate_Domains'
--header 'Authorization: Bearer <JWT Token>'

API Response

{
  "hasNextPage": false,
  "profile": [
    {
      "name": "Corporate_Domains",
      "includeSeeds": [
        {
          "seedType": "DOMAIN",
          "seedValue": "example.com",
          "seedHeading": null,
          "enumerateSubsidiary": false,
          "horizontalEnumeration": false,
          "seedFilters": [],
          "verticalEnumeration": false,
          "seedFileName": null
        }
      ],
      "excludeSeeds": [],
      "active": true,
      "profileTagName": "Corporate_Domains",
      "enableEASMScan": true,
      "includeVMAssets": false,
      "excludeCDNAssets": true,
      "excludeCloudAssets": true,
      "includeMapScanIps": false,
      "networkIdsForMapScan": [],
      "defaultPurgeRuleFrequency": 3,
      "excludeDefamatoryDomain": true,
      "enableTyposquattedDomainGeneration": false,
      "enableDomainSecurity": false,
      "easmScanAssetsScoping": null
    }
  ]
}