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 |
| 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
includeMapScanIpsandnetworkIdsForMapScanparameters. - VMDR map scans must be configured and completed for the selected networks.
The following EASM profile APIs support the new parameters:
- Create EASM Profile API
- Update EASM Profile Data API
- Patch EASM Profile Data API
- Get EASM Profile Data API
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.
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.
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.
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:
- Create EASM Profile API
- Update EASM Profile Data API
- Patch EASM Profile Data API
- Get EASM Profile Data API
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.
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.
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.
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
}
]
}