Patch Management Release 3.12 API
February 09, 2026
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.
Updated API: Create MTG Deployment Job 
| New or Updated API | Updated |
| API Endpoint | /mtg/v1/deploymentjob |
| Method | POST |
| DTD or XSD changes | Not Applicable |
With this release, we have updated the Create MTG Deployment Job API in which you can now include the Asset IDs in the On-Demand and Run Once mitigation jobs. Earlier, only Asset Tag IDs were included in the jobs. This enhancement is applicable to both Windows and Linux platforms and is helpful to include individual assets in the job.
Sample - Create On-Demand MTG Deployment JobSample - Create On-Demand MTG Deployment Job
API Request
curl -X 'POST' \
'<qualys_base_url>/mtg/v1/deploymentjob' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer_Token>' \
-H 'Content-Type: application/json' \
-d '
API Body
{
"qids": [
90007,90043
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"assetTagIds":[
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"name": "Windows_MTG_OnDemand_Job",
"description": "Test Windows On-Demand Mitigation Job",
"scheduleType": "On-demand",
"schemaVersion": "1.0",
"status": "Enabled",
"type": "Install",
"filterType": "Any",
"exclusionFilterType": "Any",
"platform": "Windows",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": 80
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
}
}'
API Response
{
"customerId": "bbb55e58-b06f-fd7b-81b8-92a7c5407282",
"id": "756aa782-8f11-4468-8e68-d1db74c7203e",
"schemaVersion": "1.0",
"name": "Windows_MTG_OnDemand_Job",
"description": "Test Windows On-Demand Mitigation Job",
"type": "Install",
"status": "Enabled",
"coAuthorUserIds": null,
"scheduleType": "On-demand",
"startDateTime": "2026-1-23 04:27:51 AM",
"recurring": false,
"timezoneType": "SPECIFIC_TZ",
"timezone": "UTC",
"createdBy": {
"user": {
"id": "f080cf76-0de1-fd80-826c-ea22cf7da868",
"name": "quaysxkm30",
"fullName": "John Doe"
},
"date": 1769142471331,
"context": null
},
"updatedBy": {
"user": null,
"date": null,
"context": null
},
"deletedBy": {
"user": null,
"date": null,
"context": null
},
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 1,
"totalAssetCount": null,
"assetResultReceivedCount": null,
"jobCategory": 3,
"jobTriggerStatus": null,
"completionPercent": null,
"jobSource": 3,
"readOnly": false,
"subCategory": "Mitigation",
"platform": "Windows",
"assetTagIds": [
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"matchAllTagIds": null,
"exclusionTagIds": null,
"filterType": "Any",
"exclusionFilterType": "Any",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": "80"
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
},
"assetDetectionsQQL": "(tags.uuid: [576b4fab-2682-433e-b3e6-c4ea9861ae75]) OR (agentId: [28e69c01-8e59-4520-83da-a934becf9d88]) AND trackingMethod:QAGENT",
"preDeployActions": [
{
"actionId": "1e8b264f-6689-426b-a395-ca288e554781",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90007,
"qidDetectionId": 0,
"hostVulnId": 0
},
"mitigationList": [
{
"cves": [
"90007"
],
"mitigationId": "d7e1f429-e0bd-4aac-83d2-ffabbb25e084",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 263935419,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
},
{
"actionId": "ae7631c7-e0af-441f-81e4-cd88a340ed2e",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90043,
"qidDetectionId": 0,
"hostVulnId": 0
},
"mitigationList": [
{
"cves": [
"90043"
],
"mitigationId": "99138ea7-1f1a-4ec8-a755-927913c3ee11",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 934571954,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
}
],
"postDeployActions": null,
"vulnQQL": "vulnerabilities.vulnerability.qid:[90007, 90043]"
}
Sample - Create Run Once Windows Mitigation JobSample - Create Run Once Windows Mitigation Job
API Request
curl -X 'POST' \ '<qualys_base_url>/mtg/v1/deploymentjob' \ -H 'accept: application/json' \ -H 'Authorization: Bearer <Bearer_Token>' \ -H 'Content-Type: application/json' \ -d '
API Body
{
"qids": [
90007,
90043
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"assetTagIds": [
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"name": "MTG_RunOnce_Job",
"description": "Test Windows Run-Once Mitigation Job",
"scheduleType": "Once",
"schemaVersion": "1.0",
"startDateTime": "2026-01-23 10:09:58 AM",
"status": "Enabled",
"timezone": "Asia/Kolkata",
"timezoneType": "SPECIFIC_TZ",
"type": "Install",
"filterType": "Any",
"exclusionFilterType": "Any",
"exclusionTagIds": [],
"matchAllTagIds": [],
"coAuthorUserIds": [],
"platform": "Windows",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": 80
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
}
}'
API Response
{
"customerId": "bbb55e58-b06f-fd7b-81b8-92a7c5407282",
"id": "d6a2dbae-9f78-4947-9c15-c6dc2a0f56ef",
"schemaVersion": "1.0",
"name": "MTG_RunOnce_Job",
"description": "Test Windows Run-Once Mitigation Job",
"type": "Install",
"status": "Enabled",
"coAuthorUserIds": [],
"scheduleType": "Once",
"startDateTime": "2026-01-23 10:09:58 AM",
"recurring": false,
"timezoneType": "SPECIFIC_TZ",
"timezone": "Asia/Kolkata",
"createdBy": {
"user": {
"id": "f080cf76-0de1-fd80-826c-ea22cf7da868",
"name": "quaysxkm30",
"fullName": "John Doe"
},
"date": 1769143677844,
"context": null
},
"updatedBy": {
"user": null,
"date": null,
"context": null
},
"deletedBy": {
"user": null,
"date": null,
"context": null
},
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 1,
"totalAssetCount": null,
"assetResultReceivedCount": null,
"jobCategory": 3,
"jobTriggerStatus": null,
"completionPercent": null,
"jobSource": 3,
"readOnly": false,
"subCategory": "Mitigation",
"platform": "Windows",
"assetTagIds": [
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"matchAllTagIds": [],
"exclusionTagIds": [],
"filterType": "Any",
"exclusionFilterType": "Any",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": "80"
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
},
"assetDetectionsQQL": "(tags.uuid: [576b4fab-2682-433e-b3e6-c4ea9861ae75]) OR (agentId: [28e69c01-8e59-4520-83da-a934becf9d88]) AND trackingMethod:QAGENT",
"preDeployActions": [
{
"actionId": "403055d1-2040-45bc-96d3-6cdf43eb32d3",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90007,
"qidDetectionId": 0,
"hostVulnId": 0
},
"mitigationList": [
{
"cves": [
"90007"
],
"mitigationId": "d7e1f429-e0bd-4aac-83d2-ffabbb25e084",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 263935419,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
},
{
"actionId": "eaf66898-5ef8-415f-8e28-faf40c9c4433",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90043,
"qidDetectionId": 0,
"hostVulnId": 0
},
"mitigationList": [
{
"cves": [
"90043"
],
"mitigationId": "99138ea7-1f1a-4ec8-a755-927913c3ee11",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 934571954,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
}
],
"postDeployActions": null,
"vulnQQL": "vulnerabilities.vulnerability.qid:[90007, 90043]"
}
Updated API: Get Mitigation Job Details 
| New or Updated API | Updated |
| API Endpoint | /mtg/v1/deploymentjob/{deploymentJobId} |
| Method | GET |
| DTD or XSD changes | Not Applicable |
With this release, we have updated the Get Mitigation Job Details API that provides the Asset IDs in the API response and supports Windows and Linux platforms. This enhancement fetches the Asset IDs included in the deployment job. Earlier, only Asset Tag IDs were fetched in the deployment jobs.
Input ParametersInput Parameters
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
| deploymentJobId | Mandatory | String | Specify the job ID. |
Sample - Get Mitigation Job DetailsSample - Get Mitigation Job Details
API Request
curl -X 'GET' \
'<qualys_base_url>/mtg/v1/deploymentjob/756aa782-8f11-4468-8e68-d1db74c7203e' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer_Token>'
API Response
{
"customerId": "bbb55e58-b06f-fd7b-81b8-92a7c5407282",
"id": "756aa782-8f11-4468-8e68-d1db74c7203e",
"schemaVersion": "1.0",
"name": "Windows_MTG_OnDemand_Job",
"description": "Test Windows On-Demand Mitigation Job",
"type": "Install",
"status": "Assets Responded",
"coAuthorUserIds": null,
"scheduleType": "On-demand",
"startDateTime": "2026-1-23 04:27:51 AM",
"recurring": false,
"timezoneType": "SPECIFIC_TZ",
"timezone": "UTC",
"createdBy": {
"user": {
"id": "f080cf76-0de1-fd80-826c-ea22cf7da868",
"name": "quaysxkm30",
"fullName": "John Doe"
},
"date": 1769142471331,
"context": null
},
"updatedBy": {
"user": null,
"date": null,
"context": null
},
"deletedBy": {
"user": null,
"date": null,
"context": null
},
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 6,
"totalAssetCount": 6,
"assetResultReceivedCount": 4,
"jobCategory": 3,
"jobTriggerStatus": 1,
"completionPercent": 66,
"jobSource": 3,
"readOnly": false,
"subCategory": "Mitigation",
"platform": "Windows",
"assetTagIds": [
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"matchAllTagIds": null,
"exclusionTagIds": null,
"filterType": "Any",
"exclusionFilterType": "Any",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": "80"
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
},
"assetDetectionsQQL": "(tags.uuid: [576b4fab-2682-433e-b3e6-c4ea9861ae75]) OR (agentId: [28e69c01-8e59-4520-83da-a934becf9d88]) AND trackingMethod:QAGENT",
"preDeployActions": [
{
"actionId": "1e8b264f-6689-426b-a395-ca288e554781",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90007,
"qidDetectionId": 0,
"qidTitle": "Enabled Cached Logon Credential",
"hostVulnId": 0,
"qds": 50,
"detectionScoreMin": 50,
"detectionScoreMax": 50
},
"mitigationList": [
{
"cves": [
"90007"
],
"mitigationId": "d7e1f429-e0bd-4aac-83d2-ffabbb25e084",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 263935419,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
},
{
"actionId": "ae7631c7-e0af-441f-81e4-cd88a340ed2e",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90043,
"qidDetectionId": 0,
"qidTitle": "SMB Signing Disabled or SMB Signing Not Required",
"hostVulnId": 0,
"qds": 35,
"detectionScoreMin": 35,
"detectionScoreMax": 35
},
"mitigationList": [
{
"cves": [
"90043"
],
"mitigationId": "99138ea7-1f1a-4ec8-a755-927913c3ee11",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 934571954,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
}
],
"postDeployActions": null,
"vulnQQL": "vulnerabilities.vulnerability.qid:[90007, 90043]"
}
Updated API: Update Mitigation Deployment Job 
| New or Updated API | Updated |
| API Endpoint | /mtg/v1/deploymentjob/{deploymentJobId} |
| Method | PATCH |
| DTD or XSD changes | Not Applicable |
With this release, we have enhanced the Update MTG Deployment Job API in which you can now update the Asset IDs in the On-Demand and Run Once mitigation jobs. This enhancement is applicable to both Windows and Linux platforms and is helpful to include individual assets in the job.
Input ParametersInput Parameters
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
| deploymentJobId | Mandatory | String | Specify the job ID. |
Sample - Update On-Demand MTG Deployment Job Sample - Update On-Demand MTG Deployment Job
API Request
curl -X 'PATCH' \
'<qualys_base_url>/mtg/v1/deploymentjob/02afe166-b5fa-4bc2-9b0e-3008a83b69b4' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer_Token>' \
-H 'Content-Type: application/json' \
-d '
API Body
{
"qids": [
90007,
90043
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"assetTagIds": [
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"name": "Win_MTG_OnDemand_Job_",
"description": "Test Windows On-Demand Mitigation Job",
"scheduleType": "On-demand",
"schemaVersion": "1.0",
"status": "Enabled",
"type": "Install",
"filterType": "Any",
"exclusionFilterType": "Any",
"platform": "Windows",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": 80
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
}
}'
API Response
{
"customerId": "bbb55e58-b06f-fd7b-81b8-92a7c5407282",
"id": "02afe166-b5fa-4bc2-9b0e-3008a83b69b4",
"schemaVersion": "1.0",
"name": "Win_MTG_OnDemand_Job_",
"description": "Test Windows On-Demand Mitigation Job",
"type": "Install",
"status": "Enabled",
"coAuthorUserIds": null,
"scheduleType": "On-demand",
"startDateTime": null,
"recurring": false,
"timezoneType": null,
"timezone": null,
"createdBy": null,
"updatedBy": {
"user": {
"id": "f080cf76-0de1-fd80-826c-ea22cf7da868",
"name": "quaysxkm30",
"fullName": null
},
"date": 1769145196428,
"context": null
},
"deletedBy": null,
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 1,
"totalAssetCount": null,
"assetResultReceivedCount": null,
"jobCategory": 3,
"jobTriggerStatus": null,
"completionPercent": null,
"jobSource": 3,
"readOnly": false,
"subCategory": "Mitigation",
"platform": "Windows",
"assetTagIds": [
"576b4fab-2682-433e-b3e6-c4ea9861ae75"
],
"assetIds": [
"28e69c01-8e59-4520-83da-a934becf9d88"
],
"matchAllTagIds": null,
"exclusionTagIds": null,
"filterType": "Any",
"exclusionFilterType": "Any",
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "[email protected],[email protected]",
"completedPercentage": "80"
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": true
}
},
"assetDetectionsQQL": "(tags.uuid: [576b4fab-2682-433e-b3e6-c4ea9861ae75]) OR (agentId: [28e69c01-8e59-4520-83da-a934becf9d88]) AND trackingMethod:QAGENT",
"preDeployActions": [
{
"actionId": "42034df2-03fa-4060-ab14-86f5471dac7c",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90007,
"qidDetectionId": 0,
"hostVulnId": 0
},
"mitigationList": [
{
"cves": [
"90007"
],
"mitigationId": "d7e1f429-e0bd-4aac-83d2-ffabbb25e084",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 263935419,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
},
{
"actionId": "857d9763-d15d-4db6-966f-8b97a7be5571",
"action": "Apply Mitigation",
"actionType": "predeploy",
"params": {
"timeout": 180,
"mitigationCategory": "Script-based Virtual Patch",
"qid": 90043,
"qidDetectionId": 0,
"hostVulnId": 0
},
"mitigationList": [
{
"cves": [
"90043"
],
"mitigationId": "99138ea7-1f1a-4ec8-a755-927913c3ee11",
"mitigationType": "Registry Update",
"mitigationSource": null,
"carScriptId": 934571954,
"customCdnUrl": "",
"signatureHashCode": "",
"impactFactor": 0,
"implication": 1
}
],
"actionLinkedToJob": false
}
],
"postDeployActions": null,
"vulnQQL": "vulnerabilities.vulnerability.qid:[90007, 90043]"
}
Updated API: Create Deployment Job 
| New or Updated API | Updated |
| API Endpoint | /pm/v1/deploymentjob/update/{deploymentJobId} |
| Method | POST |
| DTD or XSD changes | Not Applicable |
With this release, enhanced the Create Deployment Job API in which you can set the random downtime parameter to 8 hours. . This extended time allows the agent to download patches at more intervals and this is helpful for patch jobs that has more number of patches to be deployed.
Input ParametersInput Parameters
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
| downloadRandomizeTimeUnit | Optional | String | Provide the download Randomize time unit as "HOURS" or "MINUTES". Note: You can now set this time to 8 hours. |
Sample - Create Windows Deployment JobSample - Create Windows Deployment Job
API Request
curl -X POST
"<QualysBaseURL>/pm/v1/deploymentjob"
-H "accept: application/json"
-H "Authorization: Bearer <<JWT token>>"
API Body
{
"name": "Randomize_publicAPIDoc",
"description": "",
"type": "Install",
"status": "Enabled",
"coAuthorUserIds": null,
"scheduleType": "On-demand",
"startDateTime": "2026-1-28 06:43:53 AM",
"recurring": false,
"timezoneType": "SPECIFIC_TZ",
"timezone": "UTC",
"createdBy": {
"user": {
"id": "9bf883ed-788a-69ac-8295-3b7822fdb641",
"name": "username1",
"fullName": "John Doe"
},
"date": 1769582633650,
"context": null
},
"updatedBy": {
"user": null,
"date": null,
"context": null
},
"deletedBy": {
"user": null,
"date": null,
"context": null
},
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 2,
"totalAssetCount": null,
"assetResultReceivedCount": null,
"jobCategory": 3,
"jobTriggerStatus": null,
"completionPercent": null,
"jobSource": 2,
"readOnly": false,
"subCategory": "Patch",
"platform": "Windows",
"assetIds": [
"269c7084-4712-46b3-a4b1-ea03632c4330",
"db854e92-2906-44ff-bdb5-b48325b90e47"
],
"assetTagIds": null,
"matchAllTagIds": null,
"exclusionTagIds": null,
"exclusionAssetIds": null,
"approvedPatches": [
"192098db-d337-3914-94cc-60382e550094",
"3f8567f4-4848-3116-84da-1c965eade906",
"48dc6993-9222-31e4-9727-21dc12182855",
"b44a8452-7fd6-31a4-b4c5-640b43128a39"
],
"disabledPatches": null,
"patchCount": 4,
"recurringWeekDays": "",
"dayOfMonth": null,
"recurringDayOfMonth": null,
"recurringWeekDayOfMonth": null,
"timeout": -1,
"timeoutUnit": "HOURS",
"preDeployment": {
"userMessage": "",
"description": "",
"deferment": {
"intervalUnit": "HOURS"
}
},
"duringDeployment": {
"userMessage": "",
"description": ""
},
"postDeployment": {
"suppressReboots": false,
"rebootHonorOnUserLogin": false,
"rebootOption": {
"userMessage": "",
"description": "",
"deferment": {
"intervalUnit": "HOURS"
}
},
"rebootCountdown": {
"interval": 15,
"intervalUnit": "MINUTES",
"userMessage": "Reboot countdown started",
"description": "The system reboot is initiated. It will reboot automatically after the timer countdown."
},
"onComplete": {
"userMessage": "",
"description": "",
"alwaysShowCompletedPrompt": false
}
},
"opportunisticDownloads": false,
"filterType": "Any",
"exclusionFilterType": "Any",
"minimizeWindow": false,
"dynamicPatchesQQL": "",
"isDynamicPatchesQQL": false,
"dynamicQQLType": 1,
"assetDetectionsQQL": "",
"continueOnPatchFailure": false,
"preDeployActions": null,
"postDeployActions": null,
"monthlyRecurringType": null,
"patchTuesdayPlusXDays": null,
"recurringLastDayOfMonth": false,
"notification": null,
"linkedJobId": null,
"linkedToJob": null,
"linkedJobs": null,
"jobStartCountdown": null,
"passwordAction": null,
"additionalDynamicQQLType": null,
"additionalDynamicPatchesQQL": null,
"downloadRandomizeTime": 8,
"downloadRandomizeTimeUnit": "HOURS",
"customPatchURLId": null,
"isVulnContext": false,
"remediationQids": null,
"isAssetImported": false,
"enableReattemptFailedPatches": false,
"reattemptFailedPatches": {
"noOfReattempts": 0,
"exponentialBackoffInterval": 0
},
"allowExecutionWithPendingReboot": false,
"isDefaultJob": false,
"defaultJobConfiguration": {
"onAssetActivation": false,
"onAssetInactiveForXDays": null
}
}
API Response
{
"customerId": "f0943390-ea00-ca52-8302-1cccc04ee064",
"id": "32e9a0ab-efb8-45e6-99ba-5f7025bf5a56",
"schemaVersion": "1.0",
"name": "Randomize_publicAPIDoc",
"description": "",
"type": "Install",
"status": "Enabled",
"coAuthorUserIds": null,
"scheduleType": "On-demand",
"startDateTime": "2026-1-28 06:45:57 AM",
"recurring": false,
"timezoneType": "SPECIFIC_TZ",
"timezone": "UTC",
"createdBy": {
"user": {
"id": "9bf883ed-788a-69ac-8295-3b7822fdb641",
"name": "username2",
"fullName": "John Doe"
},
"date": 1769582757753,
"context": null
},
"updatedBy": {
"user": null,
"date": null,
"context": null
},
"deletedBy": {
"user": null,
"date": null,
"context": null
},
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 2,
"totalAssetCount": null,
"assetResultReceivedCount": null,
"jobCategory": 3,
"jobTriggerStatus": null,
"completionPercent": null,
"jobSource": 3,
"readOnly": false,
"subCategory": "Patch",
"platform": "Windows",
"assetIds": [
"db854e92-2906-44ff-bdb5-b48325b90e47",
"269c7084-4712-46b3-a4b1-ea03632c4330"
],
"assetTagIds": null,
"matchAllTagIds": null,
"exclusionTagIds": null,
"exclusionAssetIds": null,
"approvedPatches": [
"3f8567f4-4848-3116-84da-1c965eade906",
"192098db-d337-3914-94cc-60382e550094",
"48dc6993-9222-31e4-9727-21dc12182855",
"b44a8452-7fd6-31a4-b4c5-640b43128a39"
],
"disabledPatches": null,
"patchCount": 4,
"recurringWeekDays": "",
"dayOfMonth": null,
"recurringDayOfMonth": null,
"recurringWeekDayOfMonth": null,
"timeout": -1,
"timeoutUnit": "HOURS",
"preDeployment": {
"userMessage": "",
"description": "",
"deferment": {
"count": 0,
"interval": 0,
"intervalUnit": "HOURS"
}
},
"duringDeployment": {
"userMessage": "",
"description": ""
},
"postDeployment": {
"suppressReboots": false,
"rebootHonorOnUserLogin": false,
"rebootOption": {
"userMessage": "",
"description": "",
"deferment": {
"count": 0,
"interval": 0,
"intervalUnit": "HOURS"
}
},
"rebootCountdown": {
"interval": 15,
"intervalUnit": "MINUTES",
"userMessage": "Reboot countdown started",
"description": "The system reboot is initiated. It will reboot automatically after the timer countdown."
},
"onComplete": {
"userMessage": "",
"description": "",
"alwaysShowCompletedPrompt": false
}
},
"opportunisticDownloads": false,
"filterType": "Any",
"exclusionFilterType": "Any",
"minimizeWindow": false,
"dynamicPatchesQQL": "",
"isDynamicPatchesQQL": false,
"dynamicQQLType": 1,
"assetDetectionsQQL": "",
"continueOnPatchFailure": false,
"preDeployActions": null,
"postDeployActions": null,
"monthlyRecurringType": null,
"patchTuesdayPlusXDays": null,
"recurringLastDayOfMonth": false,
"notification": null,
"linkedJobId": null,
"linkedToJob": null,
"linkedJobs": null,
"jobStartCountdown": null,
"passwordAction": null,
"additionalDynamicQQLType": null,
"additionalDynamicPatchesQQL": null,
"downloadRandomizeTime": 8,
"downloadRandomizeTimeUnit": "HOURS",
"customPatchURLId": null,
"isVulnContext": false,
"remediationQids": null,
"isAssetImported": false,
"enableReattemptFailedPatches": false,
"reattemptFailedPatches": {
"noOfReattempts": 0,
"exponentialBackoffInterval": 0
},
"allowExecutionWithPendingReboot": false,
"isDefaultJob": false,
"defaultJobConfiguration": {
"onAssetActivation": false,
"onAssetInactiveForXDays": null
}
}
Updated API: Update Deployment Job 
| New or Updated API | Updated |
| API Endpoint | /pm/v1/deploymentjob/update/{deploymentJobId} |
| Method | POST |
| DTD or XSD changes | Not Applicable |
We have enhanced the Update Deployment Job API in which you can set the random downtime parameter to 8 hours. This extended time allows the agent to download patches at more intervals and this is helpful for patch jobs that has more number of patches to be deployed.
Input ParametersInput Parameters
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
| downloadRandomizeTimeUnit | Optional | String | Provide the download Randomize time unit as "HOURS" or "MINUTES". Note: You can now set this time to 8 hours. |
Sample - Update Deployment JobSample - Update Deployment Job
API Request
curl -X PATCH
"https://<QualysBaseURL>/pm/v1/deploymentjob/update/c08769ba-aa65-4b77-b224-f2c789ce7970"
-H "accept: application/json"
-H "Authorization: <<Jwt Token>>"
-H "Content-Type: application/json"
API Body
{ "customerId": "f0943390-ea00-ca52-8302-1cccc04ee064", "id": "0221be68-fa9a-4d06-b6ef-64431a8bcf19", "schemaVersion": "1.0", "name": "Random1234", "description": "", "type": "Install", "status": "Disabled", "coAuthorUserIds": null, "scheduleType": "On-demand", "startDateTime": "2026-1-28 06:43:53 AM", "recurring": false, "timezoneType": "SPECIFIC_TZ", "timezone": "UTC", "createdBy": { "user": { "id": "9bf883ed-788a-69ac-8295-3b7822fdb641", "name": "username2", "fullName": "John Doe" }, "date": 1769582633650, "context": null }, "updatedBy": { "user": null, "date": null, "context": null }, "deletedBy": { "user": null, "date": null, "context": null }, "assetCount": null, "taggedAssetCount": 0, "applicableAssetCount": 2, "totalAssetCount": null, "assetResultReceivedCount": null, "jobCategory": 3, "jobTriggerStatus": null, "completionPercent": null, "jobSource": 2, "readOnly": false, "subCategory": "Patch", "platform": "Windows", "assetIds": [ "269c7084-4712-46b3-a4b1-ea03632c4330", "db854e92-2906-44ff-bdb5-b48325b90e47" ], "assetTagIds": null, "matchAllTagIds": null, "exclusionTagIds": null, "exclusionAssetIds": null, "approvedPatches": [ "192098db-d337-3914-94cc-60382e550094", "3f8567f4-4848-3116-84da-1c965eade906", "48dc6993-9222-31e4-9727-21dc12182855", "b44a8452-7fd6-31a4-b4c5-640b43128a39" ], "disabledPatches": null, "patchCount": 4, "recurringWeekDays": "", "dayOfMonth": null, "recurringDayOfMonth": null, "recurringWeekDayOfMonth": null, "timeout": -1, "timeoutUnit": "HOURS", "preDeployment": { "userMessage": "", "description": "", "deferment": { "intervalUnit": "HOURS" } }, "duringDeployment": { "userMessage": "", "description": "" }, "postDeployment": { "suppressReboots": false, "rebootHonorOnUserLogin": false, "rebootOption": { "userMessage": "", "description": "", "deferment": { "intervalUnit": "HOURS" } }, "rebootCountdown": { "interval": 15, "intervalUnit": "MINUTES", "userMessage": "Reboot countdown started", "description": "The system reboot is initiated. It will reboot automatically after the timer countdown." }, "onComplete": { "userMessage": "", "description": "", "alwaysShowCompletedPrompt": false } }, "opportunisticDownloads": false, "filterType": "Any", "exclusionFilterType": "Any", "minimizeWindow": false, "dynamicPatchesQQL": "", "isDynamicPatchesQQL": false, "dynamicQQLType": 1, "assetDetectionsQQL": "", "continueOnPatchFailure": false, "preDeployActions": null, "postDeployActions": null, "monthlyRecurringType": null, "patchTuesdayPlusXDays": null, "recurringLastDayOfMonth": false, "notification": null, "linkedJobId": null, "linkedToJob": null, "linkedJobs": null, "jobStartCountdown": null, "passwordAction": null, "additionalDynamicQQLType": null, "additionalDynamicPatchesQQL": null, "downloadRandomizeTime": 6, "downloadRandomizeTimeUnit": "HOURS", "customPatchURLId": null, "isVulnContext": false, "remediationQids": null, "isAssetImported": false, "enableReattemptFailedPatches": false, "reattemptFailedPatches": { "noOfReattempts": 0, "exponentialBackoffInterval": 0 }, "allowExecutionWithPendingReboot": false, "isDefaultJob": false, "defaultJobConfiguration": { "onAssetActivation": false, "onAssetInactiveForXDays": null } }
API Response
{
"customerId": "f0943390-ea00-ca52-8302-1cccc04ee064",
"id": "0221be68-fa9a-4d06-b6ef-64431a8bcf19",
"schemaVersion": "1.0",
"name": "Random1234",
"description": "",
"type": "Install",
"status": "Disabled",
"coAuthorUserIds": null,
"scheduleType": "On-demand",
"startDateTime": "2026-1-28 06:43:53 AM",
"recurring": false,
"timezoneType": "SPECIFIC_TZ",
"timezone": "UTC",
"createdBy": {
"user": {
"id": "9bf883ed-788a-69ac-8295-3b7822fdb641",
"name": "username2",
"fullName": "John Doe"
},
"date": 1769582633650,
"context": null
},
"updatedBy": {
"user": {
"id": "9bf883ed-788a-69ac-8295-3b7822fdb641",
"name": "username1",
"fullName": null
},
"date": 1769583269312,
"context": null
},
"deletedBy": null,
"assetCount": null,
"taggedAssetCount": 0,
"applicableAssetCount": 2,
"totalAssetCount": null,
"assetResultReceivedCount": null,
"jobCategory": 3,
"jobTriggerStatus": null,
"completionPercent": null,
"jobSource": 2,
"readOnly": false,
"subCategory": "Patch",
"platform": "Windows",
"assetIds": [
"db854e92-2906-44ff-bdb5-b48325b90e47",
"269c7084-4712-46b3-a4b1-ea03632c4330"
],
"assetTagIds": null,
"matchAllTagIds": null,
"exclusionTagIds": null,
"exclusionAssetIds": null,
"approvedPatches": [
"3f8567f4-4848-3116-84da-1c965eade906",
"192098db-d337-3914-94cc-60382e550094",
"48dc6993-9222-31e4-9727-21dc12182855",
"b44a8452-7fd6-31a4-b4c5-640b43128a39"
],
"disabledPatches": null,
"patchCount": 4,
"recurringWeekDays": "",
"dayOfMonth": null,
"recurringDayOfMonth": null,
"recurringWeekDayOfMonth": null,
"timeout": -1,
"timeoutUnit": "HOURS",
"preDeployment": {
"userMessage": "",
"description": "",
"deferment": {
"count": 0,
"interval": 0,
"intervalUnit": "HOURS"
}
},
"duringDeployment": {
"userMessage": "",
"description": ""
},
"postDeployment": {
"suppressReboots": false,
"rebootHonorOnUserLogin": false,
"rebootOption": {
"userMessage": "",
"description": "",
"deferment": {
"count": 0,
"interval": 0,
"intervalUnit": "HOURS"
}
},
"rebootCountdown": {
"interval": 15,
"intervalUnit": "MINUTES",
"userMessage": "Reboot countdown started",
"description": "The system reboot is initiated. It will reboot automatically after the timer countdown."
},
"onComplete": {
"userMessage": "",
"description": "",
"alwaysShowCompletedPrompt": false
}
},
"opportunisticDownloads": false,
"filterType": "Any",
"exclusionFilterType": "Any",
"minimizeWindow": false,
"dynamicPatchesQQL": "",
"isDynamicPatchesQQL": false,
"dynamicQQLType": 1,
"assetDetectionsQQL": "",
"continueOnPatchFailure": false,
"preDeployActions": null,
"postDeployActions": null,
"monthlyRecurringType": null,
"patchTuesdayPlusXDays": null,
"recurringLastDayOfMonth": false,
"notification": null,
"linkedJobId": null,
"linkedToJob": null,
"linkedJobs": null,
"jobStartCountdown": null,
"passwordAction": null,
"additionalDynamicQQLType": null,
"additionalDynamicPatchesQQL": null,
"downloadRandomizeTime": 6,
"downloadRandomizeTimeUnit": "HOURS",
"customPatchURLId": null,
"isVulnContext": false,
"remediationQids": [],
"isAssetImported": false,
"enableReattemptFailedPatches": false,
"reattemptFailedPatches": {
"noOfReattempts": 0,
"exponentialBackoffInterval": 0
},
"allowExecutionWithPendingReboot": false,
"isDefaultJob": false,
"defaultJobConfiguration": {
"onAssetActivation": false,
"onAssetInactiveForXDays": null
}
}
Extended Limits for Deployment Job Co-Authors

With this release, we have updated certain Deployment Job APIs with v2 version. These APIs are enhanced to restrict addition of only 200 users as co-authors to a deployment job. If you try to add more than 200 co-authors to a job, the API response displays an error.
The impacted APIs are:
Create Mitigation Job
| New or Updated API | Updated |
| API Endpoint | /mtg/v1/deploymentjob |
| EOS Timeline: February 2026 | |
| EOL Timeline: July 2026 | |
| API Endpoint (New Version) | /mtg/v2/deploymentjob |
| Method | POST |
| DTD or XSD changes | Not Applicable |
Update Mitigation Job for Specified ID
| New or Updated API | Updated |
| API Endpoint | /mtg/v1/deploymentjob/{deploymentJobId} |
| EOS Timeline: February 2026 | |
| EOL Timeline: July 2026 | |
| API Endpoint (New Version) | /mtg/v2/deploymentjob/{deploymentJobId} |
| Method | PATCH |
| DTD or XSD changes | Not Applicable |
Create Patch Deployment Job
| New or Updated API | Updated |
| API Endpoint | /pm/v1/deploymentjob |
| EOS Timeline: February 2026 | |
| EOL Timeline: August 2026 | |
| API Endpoint (New Version) | /pm/v2/deploymentjob |
| Method | POST |
| DTD or XSD changes | Not Applicable |
Update Patch Deployment Job for Specified Job ID
| New or Updated API | Updated |
| API Endpoint | /pm/v1/deploymentjob/update/{deploymentJobId} |
| EOS Timeline: February 2026 | |
| EOL Timeline: August 2026 | |
| API Endpoint (New Version) | /pm/v2/deploymentjob/update/{deploymentJobId} |
| Method | PATCH |
| DTD or XSD changes | Not Applicable |
Input ParametersInput Parameters
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
| coAuthorUserIds | Optional | String | Specify the userIDs of the users that must be added as co-authors to the job. Note: The maximim limit is 200. |
Sample - Update Patch Deployment Job for Co-Author RestrictionSample - Update Patch Deployment Job for Co-Author Restriction
API Request
curl -X PATCH
"https://<QualysBaseURL>/pm/v2/deploymentjob/update/16be09aa-5415-4a58-8295-8a4ac8db6f26"
-H "accept: application/json"
-H "Authorization: Bearer <<Jwt Token>>"
-H "Content-Type: application/json
API Body
{ "approvedPatches": [ "865048a1-ad00-30e4-83c0-68ed70b2b4ad" ], "dynamicPatchesQQL": "", "isDynamicPatchesQQL": false, "dynamicQQLType": 1, "additionalDynamicPatchesQQL": "", "additionalDynamicQQLType": "", "linkedJobId": "", "chainedJobRule": [], "assetCount": 0, "assetIds": [], "isAssetImported": false, "assetFilePath": null, "assetTagIds": [ "c4c928b0-ab93-44ff-9da9-f56ad109d2eb" ], "assetDetectionsQQL": "", "deleted": false, "duringDeployment": { "userMessage": "", "description": "" }, "name": "API_notification_deployment_job", "description": "", "patchCount": 1, "createdBy": { "user": { "id": "ce0bb83b-e158-5a18-83b4-9dfc3079fe99", "name": "johnd", "fullName": "John Doe" }, "date": "1770014944210", "context": null }, "postDeployment": { "suppressreboots": false, "rebootHonorOnUserLogin": false, "onComplete": { "userMessage": "", "description": "", "alwaysShowCompletedPrompt": false }, "rebootCountdown": { "interval": 15, "intervalUnit": "MINUTES", "userMessage": "Reboot countdown started", "description": "The system reboot is initiated. It will reboot automatically after the timer countdown." }, "rebootOption": { "deferment": { "count": null, "interval": null, "intervalUnit": "HOURS" }, "userMessage": "", "description": "" } }, "preDeployment": { "deferment": { "count": null, "interval": null, "intervalUnit": "HOURS" }, "userMessage": "", "description": "" }, "recurring": false, "dayOfMonth": null, "recurringLastDayOfMonth": false, "patchTuesdayPlusXDays": null, "monthlyRecurringType": null, "recurringDayOfMonth": null, "recurringWeekDayOfMonth": null, "recurringWeekDays": "", "scheduleType": "On-demand", "schemaVersion": "1.0", "startDateTime": null, "status": "Disabled", "opportunisticdownloads": false, "minimizeWindow": false, "enableReattemptFailedPatches": false, "reattemptFailedPatches": { "noOfReattempts": 0, "exponentialBackoffInterval": 0 }, "allowExecutionWithPendingReboot": false, "timeout": -1, "timeoutUnit": "HOURS", "downloadRandomizeTime": 0, "downloadRandomizeTimeUnit": "MINUTES", "timezone": null, "timezoneType": null, "type": "Install", "filterType": "Any", "exclusionFilterType": "Any", "exclusionTagIds": [], "matchAllTagIds": [], "coAuthorUserIds": [ "ca48b162-4783-fb2b-819f-228d71974994", "ce0bb83b-e158-5a18-83b4-9dfc3079fe99", ... ... ... "857df385-1ce2-4c06-8337-a771ff92085d", "552f43c0-fe66-d247-8051-faae1e64c2e6", "5634861c-4128-c60a-8071-34f826d6e498" ], "exclusionAssetIds": [], "preDeployActions": [], "postDeployActions": [], "jobCategory": 3, "jobSource": 2, "platform": "Windows", "notification": null, "customPatchURLId": null, "remediationQids": [], "isVulnContext": false, "subCategory": "Patch", "hostIsolationConfig": null, "quarantineAssetRequestNotification": null, "isDefaultJob": false, "defaultJobConfiguration": { "onAssetActivation": false, "onAssetInactiveForXDays": null } }
API Response
{
"_error": {
"code": 400,
"errorCode": "2435",
"message": "Co-author limit exceeded. You can add up to 200 co-authors per job"
}
}
Support IPv6 and IP4 columns in Reports
With this release, we have enhanced certain report APIs that allows you to select and include IPv6 and IPv4 column.
The impacted APIs which includes IPv6 column are:
Get List of Report Columns
| New or Updated API | Updated |
| API Endpoint | /pm/v1/report/columns |
| Method | GET |
| DTD or XSD changes | Not Applicable |
Generate Deployment Job Progress Report
| New or Updated API | Updated |
| API Endpoint | /pm/v2/report/jobprogress/{deploymentJobId} |
| Method | POST |
| DTD or XSD changes | Not Applicable |
Get Assets Tab Report
| New or Updated API | Updated |
| API Endpoint | /pm/v2/report/asset |
| Method | POST |
| DTD or XSD changes | Not Applicable |
With this release, we have enhanced the Get Assets Tab Report API that allows you to select both IPv6 and IPv4 column.
Input ParametersInput Parameters
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
| columnsToDisplay | Optional | String | Enter the key "asset Ipv6Address" and/or "assetIp". |
Sample - Get Assets Tab Report to include IPv6 and IPv4 addressSample - Get Assets Tab Report to include IPv6 and IPv4 address
API Request
curl -X 'POST' \
'<qualys_base_url>/pm/v2/report/asset'
-H 'accept: application/json'
-H 'Authorization: Bearer <JWT_Token>
-H 'Content-Type: application/json'
-d
API Body
'{
"name": "API report pdf asset",
"description": "Asset Report Description",
"platform": "Windows",
"query": "asset.status:Scanned",
"havingQuery": "patch.isRebootRequired:false",
"columnsToDisplay": {
"asset": [
"rowId",
"assetId",
"assetName",
"operatingSystem",
"assetStatus",
"scannedOn",
"assetIpv6Address"
"assetIp"
]
}
}'
API Response
{
"reportId": "50984744-10c2-4640-b24c-5d4756bf5456"
}
UI Release Updates
To know in detail about the UI features, enhancements and issues addressed, see Patch Management Release 3.12.