Create a Deployment Job

Use this API to create a deployment job by providing inputs in the request body. When you create a Windows or Linux deployment job and the request is successful, you get a 201 response code.

While creating Windows or Linux jobs, you can add patches from another job (which you can call a parent or a linked job). You can also add a condition you want to consider in the job execution. Note that the condition is based on the post-actions of the parent job. This allows you to control the run of child job execution based on the successful percentage of post-actions in the parent job.

You can choose to always show the Patch Job Deployment Completion Pop-Up Window on patched machines, for Windows deployment jobs regardless of whether the patches are failed, skipped, or successfully deployed.

POST/pm/v1/deploymentjob

Input Parameters

Parameter		Mandatory/Optional	Data Type	Description
approvedPatches		Optional	string	Specify a list of patches that you want to add to the job
filterType		Optional	string	Specify the relationship between selected tags. Available values: Any, All Default value: Any
exclusionFilterType		Optional	string	Specify the relationship between excluded tags. Available values: Any, All Default value: Any
scheduleType		Mandatory	string	Specify the schedule to run the job. Available values: On-demand, Once, Daily, Weekly, and Monthly.
startDateTime		Optional: On-demand job. Mandatory: Other job types.	string	Specify the time to start the job. Format example: 2022-2-20 01:18:30 PM
recurring		Optional		Specify if the job is recurring. Available values: True, False
dayOfMonth		Optional	string	Specify a day between 1 to 31 to run the job.
recurringLastDayOfMonth		Optional		Specify if you want to job to run on the last day of the month. Available values: True, False
monthlyRecurringType		Optional	string	Specify if you want to run the job on the Patch Tuesday schedule Available values: 0 (not - Patch Tuesday), and 1 (Patch Tuesday). Default value: 0
patchTuesdayPlusXDays		Optional	string	Specify the value to set the schedule to run the job up to 27 days before or after Patch Tuesday. When you specify a value between -1 and -27, the job runs before Patch Tuesday according to that value. When you specify a value between 1 and 27, the job runs after Patch Tuesday according to that value. Platform support: Windows and Linux
recurringDayOfMonth		Optional	string	Specify a value between 1 to 5 to run the job on a specific day of a week in the month. For example, the second Monday of the month.
recurringWeekDayOfMonth		Optional	string	Specify a value between 0-6 to run a job on a specific day of the week. For example, 0=Sunday, 1=Monday, and so on.
recurringWeekDays		Optional	string	Replace 0 with 1 in the "0,0,0,0,0,0,0" sequence to run the job on a specific day of the week. For example, "0,0,1,0,0,0,0" to run the job on Tuesday.
dynamicQQLType		Optional	string	Specify if the job is QQL type. Available values: 0 (no QQL), 1 (Patch QQL), 2 (Vulnerability QQL) Default value: 0
isDynamicPatchesQQL		Optional	Boolean	Specify if the QQL-job uses Patches tokens. Available values: True, False
continueOnPatchFailure		Optional	Boolean (Linux job only)	Specify if the Linux installation job should run after a patch in the package fails to install. Available values: True, False
preDeployment		Optional	string	Specify a message you want to show before the deployment starts. If you don't want to show a message, keep the value as null.
duringDeployment		Optional	string	Specify a message you want to show before the deployment starts. If you don't want to show a message, keep the value null.
postDeployment		Optional	string	Specify a message you want to show after the job is deployed. If you don't want to show a message, keep the value null.
onComplete		Optional	string	Specify a message you want to show after the job is complete. If you don't want to show a message, keep the value null.
rebootCountdown		Optional	string	Specify a message you want to show before reboot countdown starts. If you don't want to show a message, keep the value null.
rebootOption		Optional	string	Specify a message you want to show when the reboot is complete. If you don't want to show a message, keep the value null.
suppressReboots		Optional	string	Specify if you want to allow users to suppress a reboot after the job. Available values: True, False Default value: False
platform		Optional	string	Specify the platform type. - Available values: Linux, Windows - Default value: Windows
minimizeWindow		Optional	Boolean (Windows job only)	Specify if you want to allow users to minimize the job window. Available values: True, False Default value: False
type		Mandatory	string	Specify the job type. Available values: Install (Windows and Linux), Rollback (Windows and Linux) Default value: Install
status		Optional	string	Specify the job status. Available values: Disabled, Enabled Default value: Disabled
timeout/timeoutUnit		Optional	string	Specify if the job should time out in hours (1 to 168) or minutes (1 to 10080)
timezoneType		Optional	string	Specify if you want to run the job in the agent time zone of a specific time zone. Available values: AGENT_TZ, SPECIFIC_TZ
timezone		Optional	string	Specify the time zone in which you want to run the job. To refer to the available time zones, see List of Time Zones.
opportunisticDownloads		Optional	Boolean (Windows job only)	Specify if you want the agent to attempt to download the patches before the job starts. Available values: True, False Default value: False
action		Optional	string (Windows job only)	Specify if you want to execute an action before or after a job runs. Available values (pre-actions): Run Script, Install Software, Change Registry Key, Uninstall Software, and System Reboot. Available values (post-actions): Run Script, Install Software, Change Registry Key, and Uninstall Software.
script/detectionScript		Optional	string (Windows job only)	Specify the Base 64 encoded script that you want to run as an action
scriptType		Optional	string (Windows job only)	Specify the Powershell script that you want to run as a part of the job.
detectionScriptType		Optional	string (Windows job only)	Specify the Powershell script that you want to run as a part of the job
linkedJobId		Optional	string	Specify a job ID you want to link. If you do not want to link a job, keep the value "null".
notification	-	Optional	-	Notify the user at the start and end of the job.
	notificationTypes		Boolean	Enter "true" for email.
	notificationConfigs recipientEmails completedPercentage		string integer	Enter the email IDs of recipients and the completion percentage between 1 to 100. If you do not want to notify, keep the value null.
	notificationEvents		Boolean	Enter "true" for at least one of the following parameters: "onJobStart" or "onJobComplete". Available values: true, false
downloadRandomizeTime		Optional	string	Provide the job randomize time in hours or minutes. Note: - The maximum randomize time you can provide is 2 hours or 120 minutes. - This value must be less than the timeout/timeoutUnit.(Patch Window)
downloadRandomizeTimeUnit		Optional	string	Provide the download Randomize time unit as "HOURS" or "MINUTES".
additionalDynamicQQLType		Optional	string	Specify if the job is QQL type. Available values: 1 (Patch QQL), 2 (Vulnerability QQL)
customPatchURLId		Optional	Integer	Specify the customPatchURLId value. This is nothing but the "id" value received from the Fetch Custom Patch Download URLs API.
alwaysShowCompletedPrompt		Optional	Boolean	Specify the value as true to show the Patch Job Deployment Completion Pop-Up Window, irrespective of whether the patches are failed, skipped, or successfully deployed. Available values: true and false
chainedJobRule	-	Optional	string	Specify the values in the chainedJobRule array to decide on the child job execution based on the successful percentage of post action in the parent job.
	field		string	Specify the value: postDeployAction
	actionIds		Integer	Specify the parent job post-action ID. You can provide a single or multiple IDs as per your requirement.
	threshold		Integer	The threshold in hours. Available values: 1 to 100
	condition		string	Specify the condition: Post Actions were successfully executed
preDeployActions	action	Optional	String	Specify the action. For example, Run Script
	actionItem	Optional	String	Specify the actionItem. For example, makeCache Pre-Action. (This action is only for Linux job)
	defaultScriptType	Optional	String	Specify the default script type. For example, MakeCache. (This action is only for Linux job)
	scriptType	Optional	String	Specify the scriptType. For example: sh
	script	Optional	String	The value must be empty. For example: script: " "
reattemptFailedPatches		Optional	Boolean (Windows job only)	Specify the value as True or false.
noOfReattempts		Optional	Integer (Windows job only)	Specify the number of re-attempts. Provide values between 1-5.
exponentialBackoffInterval		Optional	Integer (Windows job only)	Specify valid backoff interval between retries. Provide values between 1 to 15.

Sample - Create a Windows on-demand deployment job with pre-actions and post-actions

API request

curl -X POST
"https://<QualysBaseURL>/pm/v1/deploymentjob" -H "accept: application/json" -H "Authorization: Bearer <<jwt token>>"

Request Body - Specify the inputs to create a deployment job

{
  "name": "Public API on demand Window job with specific patches",
  "description": "Created via public API",
  "approvedPatches": [
    "444ba31a-0f94-3199-870e-ef8ab1a5a477",
    "b91fca0e-2a07-3155-909c-fc50ba1863ed"
  ],
  "assetIds": [
    "38aa48ca-a53f-4591-af01-8bce75de4ce7"
  ],
  "assetTagIds": [],
  "filterType": "Any",
  "exclusionAssetIds": [],
  "exclusionFilterType": "Any",
  "exclusionTagIds": [],
  "coAuthorUserIds": [],
  "preDeployment": null,
  "duringDeployment": {
    "description": "During deployment Description",
    "userMessage": "During deployment userMessage"
  },
  "postDeployment": {
    "onComplete": {
      "description": "On complete Description",
      "userMessage": "On complete userMessage"
    },
    "rebootCountdown": {
      "interval": 15,
      "intervalUnit": "MINUTES",
      "userMessage": "Reboot Countdown usermessage",
      "description": "Reboot Countdown description"
    },
    "rebootOption": {
      "deferment": {
        "count": 3,
        "interval": 1,
        "intervalUnit": "HOURS"
      },
      "description": "rebootOption description",
      "userMessage": "rebootOption user message"
    },
    "suppressReboots": false
  },
  "platform": "Windows",
  "minimizeWindow": "true",
  "type": "Install",
  "status": "Disabled",
  "timeout": 6,
  "timeoutUnit": "HOURS",
  "recurring": false,
  "scheduleType": "On-demand",
  "opportunisticDownloads": false,
  "enableReattemptFailedPatches": true,
  "reattemptFailedPatches": {
    "noOfReattempts": 5,
    "exponentialBackoffInterval": 15
  },
  "downloadRandomizeTime": 2,
  "downloadRandomizeTimeUnit": "HOURS",
  "notification": {
    "notificationTypes": {
      "email": true
    },
    "notificationConfigs": {
      "recipientEmails": "abc@gmail.com",
      "completedPercentage": 80
    },
    "notificationEvents": {
      "onJobStart": true,
      "onJobComplete": false
    }
  },
  "preDeployActions": [
    {
      "action": "Run Script",
      "params": {
        "actionItem": "Notepad detection script"
      },
      "script": "CJOb3RlcGFkKysgaXMgbm90IG.....luc3RhbGxlZCBvbiB5b3VyIG1hY2hpbmUuIgp9IA",
      "scriptType": "ps"
    },
    {
      "action": "Change Registry Key",
      "params": {
        "actionItem": "DisableUpdate",
        "regKey": "SEtFWV9MT0NBTF9NQUNISU5FXFNPRlRXQVJFXFpvb21cTVNJ",
        "regValueType": "REG_SZ",
        "regValue": "dHJ1ZQ==",
        "regKeyAddNew": false
      },
      "scriptType": "ps"
    },
    {
      "action": "System Reboot",
      "params": {
        "actionItem": "Reboot"
      }
    }
  ],
  "postDeployActions": [
    {
      "action": "Install Software",
      "params": {
        "actionItem": "Install Notepad",
        "downloadURL": "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.6.2/npp.7.5.8.Installer.exe",
        "fileChecksum": "613f36bf5e98be7e56b7ea0c678cfb8534077c2ec1cbe839a854dd0a60278ebb",
        "installMethod": 0
      },
      "script": "JHcNlewogICAgV3JpdG.....vbiB5b3VyIG1hY2hpbmUuIgp9IA==",
      "scriptType": "ps",
      "detectionScript": "",
      "detectionScriptType": "ps"
    },
    {
      "action": "Uninstall Software",
      "params": {
        "actionItem": "Uninstall Chrome",
        "unInstallRegistryKey": "SEtFWV9MT0NBTF9NQUNISU5FXFNPRlRXQVJFXFdPVzY0MzJOb2RlXE1pY3Jvc29mdFxXaW5kb3dzXEN1cnJlbnRWZXJzaW9uXFVuaW5zdGFsbFxHb29nbGUgQ2hyb21l",
        "unInstallSoftwareDisplayName": "Google Chrome",
        "unInstallSoftwareVersion": "109.0.5414.168",
        "unInstallSoftwareVersionMatch": "Equals"
      },
      "scriptType": "ps"
    },
    {
      "action": "Install Software",
      "params": {
        "actionItem": "Install Notepad with Installer based option",
        "downloadURL": "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.6.2/npp.7.5.8.Installer.exe",
        "fileChecksum": "613f36bf5e98be7e56b7ea0c678cfb8534077c2ec1cbe839a854dd0a60278ebb",
        "installMethod": 1
      },
      "detectionScript": "",
      "detectionScriptType": "ps",
      "script": "",
      "scriptType": "ps"
    }
  ]
}

Response

{
  "customerId": "2e5bc89e-4670-d067-83f2-b873a00f4531",
  "id": "e8eff303-9532-4a70-a399-b9dec57b4918",
  "schemaVersion": "1.0",
  "name": "Public API on demand Window job with specific patches",
  "type": "Install",
  "status": "Disabled",
  "assetIds": [
    "38aa48ca-a53f-4591-af01-8bce75de4ce7"
  ],
  "assetTagIds": [],
  "matchAllTagIds": null,
  "exclusionTagIds": [],
  "exclusionAssetIds": [],
  "coAuthorUserIds": [],
  "approvedPatches": [
    "444ba31a-0f94-3199-870e-ef8ab1a5a477",
    "b91fca0e-2a07-3155-909c-fc50ba1863ed"
  ],
  "disabledPatches": null,
  "patchCount": 2,
  "scheduleType": "On-demand",
  "startDateTime": "2025-4-14 01:45:48 PM",
  "recurring": false,
  "recurringWeekDays": null,
  "dayOfMonth": null,
  "recurringDayOfMonth": null,
  "recurringWeekDayOfMonth": null,
  "timezoneType": "SPECIFIC_TZ",
  "timezone": "UTC",
  "timeout": 6,
  "timeoutUnit": "HOURS",
  "preDeployment": {
    "userMessage": "",
    "description": "",
    "deferment": {
      "count": 3,
      "interval": 1,
      "intervalUnit": "HOURS"
    }
  },
  "duringDeployment": {
    "userMessage": "During deployment userMessage",
    "description": "During deployment Description"
  },
  "postDeployment": {
    "suppressReboots": false,
    "rebootHonorOnUserLogin": false,
    "rebootOption": {
      "userMessage": "rebootOption user message",
      "description": "rebootOption description",
      "deferment": {
        "count": 3,
        "interval": 1,
        "intervalUnit": "HOURS"
      }
    },
    "rebootCountdown": {
      "interval": 15,
      "intervalUnit": "MINUTES",
      "userMessage": "Reboot Countdown usermessage",
      "description": "Reboot Countdown description"
    },
    "onComplete": {
      "userMessage": "On complete userMessage",
      "description": "On complete Description",
      "alwaysShowCompletedPrompt": false
    }
  },
  "description": "Created via public API",
  "createdBy": {
    "user": {
      "id": "0f9775fd-c16e-51c0-83c4-c98a0f23c298",
      "name": "quays_zs93",
      "fullName": "Shilpa Sutar"
    },
    "date": 1744638348039
  },
  "updatedBy": {
    "user": null,
    "date": null
  },
  "deletedBy": {
    "user": null,
    "date": null
  },
  "assetCount": null,
  "opportunisticDownloads": false,
  "filterType": "Any",
  "exclusionFilterType": "Any",
  "taggedAssetCount": 0,
  "minimizeWindow": true,
  "dynamicPatchesQQL": null,
  "isDynamicPatchesQQL": false,
  "dynamicQQLType": null,
  "assetDetectionsQQL": null,
  "platform": "Windows",
  "continueOnPatchFailure": false,
  "preDeployActions": [
    {
      "actionId": "e4fac150-804b-4857-ae9b-606d1b136b20",
      "action": "Run Script",
      "actionType": "predeploy",
      "params": {
        "actionItem": "Notepad detection script",
        "timeout": 180
      },
      "script": "2e5bc89e-4670-d067-83f2-b873a00f4531/e4fac150-804b-4857-ae9b-606d1b136b20/Script",
      "scriptType": "ps",
      "actionLinkedToJob": false
    },
    {
      "actionId": "b1dfc7cc-7c7f-482a-b5b6-e9a9bf2dd460",
      "action": "Change Registry Key",
      "actionType": "predeploy",
      "params": {
        "actionItem": "DisableUpdate",
        "regKey": "SEtFWV9MT0NBTF9NQUNISU5FXFNPRlRXQVJFXFpvb21cTVNJ",
        "regValueType": "REG_SZ",
        "regValue": "dHJ1ZQ==",
        "regKeyAddNew": false,
        "timeout": 180
      },
      "actionLinkedToJob": false
    },
    {
      "actionId": "dc8fa457-5c41-4508-a682-725df3c05af8",
      "action": "System Reboot",
      "actionType": "predeploy",
      "params": {
        "actionItem": "Reboot",
        "timeout": 180
      },
      "script": "",
      "scriptType": "ps",
      "actionLinkedToJob": false
    }
  ],
  "postDeployActions": [
    {
      "actionId": "b479d640-189a-48d8-b4e1-6f79f034f8f3",
      "action": "Install Software",
      "actionType": "postdeploy",
      "params": {
        "actionItem": "Install Notepad",
        "downloadURL": "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.6.2/npp.7.5.8.Installer.exe",
        "downloadProtocol": 0,
        "installMethod": 0,
        "fileChecksum": "613f36bf5e98be7e56b7ea0c678cfb8534077c2ec1cbe839a854dd0a60278ebb",
        "timeout": 180
      },
      "detectionScript": "",
      "detectionScriptType": "ps",
      "script": "2e5bc89e-4670-d067-83f2-b873a00f4531/b479d640-189a-48d8-b4e1-6f79f034f8f3/Script",
      "scriptType": "ps",
      "actionLinkedToJob": false
    },
    {
      "actionId": "0698206c-76fd-4983-96e7-cc5059456249",
      "action": "Uninstall Software",
      "actionType": "postdeploy",
      "params": {
        "actionItem": "Uninstall Chrome",
        "unInstallSoftwareDisplayName": "Google Chrome",
        "unInstallSoftwareVersion": "109.0.5414.168",
        "unInstallSoftwareVersionMatch": "Equals",
        "unInstallRegistryKey": "SEtFWV9MT0NBTF9NQUNISU5FXFNPRlRXQVJFXFdPVzY0MzJOb2RlXE1pY3Jvc29mdFxXaW5kb3dzXEN1cnJlbnRWZXJzaW9uXFVuaW5zdGFsbFxHb29nbGUgQ2hyb21l",
        "timeout": 180
      },
      "actionLinkedToJob": false
    },
    {
      "actionId": "9a09a201-54d3-4d40-9256-291fc02e63c4",
      "action": "Install Software",
      "actionType": "postdeploy",
      "params": {
        "actionItem": "Install Notepad with Installer based option",
        "downloadURL": "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.6.2/npp.7.5.8.Installer.exe",
        "downloadProtocol": 0,
        "installMethod": 1,
        "fileChecksum": "613f36bf5e98be7e56b7ea0c678cfb8534077c2ec1cbe839a854dd0a60278ebb",
        "timeout": 180
      },
      "detectionScript": "",
      "detectionScriptType": "ps",
      "script": "",
      "scriptType": "ps",
      "actionLinkedToJob": false
    }
  ],
  "applicableAssetCount": 1,
  "monthlyRecurringType": null,
  "patchTuesdayPlusXDays": null,
  "recurringLastDayOfMonth": null,
  "jobCategory": 3,
  "jobTriggerStatus": null,
  "completionPercent": null,
  "totalAssetCount": null,
  "assetResultReceivedCount": null,
  "jobSource": 3,
  "readOnly": false,
  "notification": {
    "notificationTypes": {
      "email": true
    },
    "notificationConfigs": {
      "recipientEmails": "abc@gmail.com",
      "completedPercentage": "80"
    },
    "notificationEvents": {
      "onJobStart": true,
      "onJobComplete": false
    }
  },
  "linkedJobId": null,
  "linkedToJob": null,
  "linkedJobs": null,
  "jobStartCountdown": null,
  "passwordAction": null,
  "subCategory": "Patch",
  "additionalDynamicQQLType": null,
  "additionalDynamicPatchesQQL": null,
  "downloadRandomizeTime": 2,
  "downloadRandomizeTimeUnit": "HOURS",
  "customPatchURLId": null,
  "isVulnContext": null,
  "remediationQids": null,
  "isAssetImported": false,
  "hostIsolationConfig": null,
  "quarantineAssetRequestNotification": null,
  "enableReattemptFailedPatches": true,
  "reattemptFailedPatches": {
    "noOfReattempts": 5,
    "exponentialBackoffInterval": 15
  }
}

Sample - Create Windows QQL-based installation job for Patch Tuesday without actions

API request

curl -X POST
"https://<QualysBaseURL>/pm/v1/deploymentjob" -H "accept: application/json" -H "Authorization: Bearer <<jwt token>>"

Request Body - Specify the inputs to create a QQL-based Windows deployment job for Patch Tuesday without actions

-d '{
    "name": "Windows Public API job 3",
    "description": "Windows job created via public API",
    "approvedPatches": [],
    "assetIds": [
        "bdf79678-e0f3-4c96-9d5c-59b14661ec3f"
    ],
    "assetTagIds": [
        "976d805d-855f-4aa7-8713-b44463f7d081"
    ],
    "matchAllTagIds": [],
    "filterType": "Any",
    "exclusionAssetIds": [
        "e52de00f-8631-4dd5-9ff7-622f3e8d698d"
    ],
    "exclusionFilterType": "Any",
    "exclusionTagIds": [
        "22dcb264-9c2a-4d78-bc55-376396b68a08"
    ],
    "coAuthorUserIds": [
        "568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"
    ],
    "scheduleType": "Monthly",
    "startDateTime": "2022-2-20 01:18:30 PM",
    "recurring": true,
    "dayOfMonth": null,
    "recurringLastDayOfMonth": false,
    "monthlyRecurringType": 1,
    "patchTuesdayPlusXDays": 6,
    "recurringDayOfMonth": null,
    "recurringWeekDayOfMonth": null,
    "recurringWeekDays": "",
    "dynamicPatchesQQL": "isSecurity: true",
    "dynamicQQLType": "1",
    "isDynamicPatchesQQL": true,
    "continueOnPatchFailure": false,
    "downloadRandomizeTime": 15,
    "downloadRandomizeTimeUnit": "MINUTES",
    "preDeployment": {
        "deferment": {
            "count": 3,
            "interval": 1,
            "intervalUnit": "HOURS"
        },
        "description": "preDeployment description",
        "userMessage": "preDeployment user message"
    },
    "duringDeployment": {
        "description": "During deployment Description",
        "userMessage": "During deployment userMessage"
    },
    "postDeployment": {
        "onComplete": {
            "description": "On complete Description",
            "userMessage": "On complete userMessage"
        },
        "rebootCountdown": {
            "interval": 15,
            "intervalUnit": "MINUTES",
            "userMessage": "Reboot Countdown usermessage",
            "description": "Reboot Countdown description"
        },
        "rebootOption": {
            "deferment": {
                "count": 3,
                "interval": 1,
                "intervalUnit": "HOURS"
            },
            "description": "rebootOption description",
            "userMessage": "rebootOption user message"
        },
        "suppressReboots": false
    },
    "platform": "Windows",
    "minimizeWindow": "true",
    "type": "Install",
    "status": "Disabled",
    "timeout": 6,
    "timeoutUnit": "HOURS",
    "timezone": null,
    "timezoneType": "AGENT_TZ",
    "opportunisticDownloads": true,
    "additionalDynamicPatchesQQL":
    "vulnerabilities.vulnerability.criticality:CRITICAL",
    "additionalDynamicQQLType": 2,
    "customPatchURLId": 1004
}'

Response

{
    "customerId": "6f66747e-2800-7fc7-82d4-1ee7cd30c9fc",
    "id": "7dc64a73-f347-4ed4-b50c-9c645b334907",
    "schemaVersion": "1.0",
    "name": "Winodws Public API job 3",
    "type": "Install",
    "status": "Disabled",
    "assetIds": [
        "bdf79678-e0f3-4c96-9d5c-59b14661ec3f"
    ],
    "assetTagIds": [
        "976d805d-855f-4aa7-8713-b44463f7d081"
    ],
    "matchAllTagIds": [],
    "exclusionTagIds": [
        "22dcb264-9c2a-4d78-bc55-376396b68a08"
    ],
    "exclusionAssetIds": [
        "e52de00f-8631-4dd5-9ff7-622f3e8d698d"
    ],
    "coAuthorUserIds": [
        "568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"
    ],
    "approvedPatches": [],
    "disabledPatches": null,
    "patchCount": 0,
    "scheduleType": "Monthly",
    "startDateTime": "2022-2-20 01:18:30 PM",
    "recurring": true,
    "recurringWeekDays": "",
    "dayOfMonth": null,
    "recurringDayOfMonth": null,
    "recurringWeekDayOfMonth": null,
    "timezoneType": "AGENT_TZ",
    "timezone": null,
    "timeout": 6,
    "timeoutUnit": "HOURS",
    "preDeployment": {
        "userMessage": "preDeployment user message",
        "description": "preDeployment description",
        "deferment": {
            "count": 3,
            "interval": 1,
            "intervalUnit": "HOURS"
        }
    },
    "duringDeployment": {
        "userMessage": "During deployment userMessage",
        "description": "During deployment Description"
    },
    "postDeployment": {
        "suppressReboots": false,
        "rebootOption": {
            "userMessage": "rebootOption user message",
            "description": "rebootOption description",
            "deferment": {
                "count": 3,
                "interval": 1,
                "intervalUnit": "HOURS"
            }
        },
        "rebootCountdown": {
            "interval": 15,
            "intervalUnit": "MINUTES",
            "userMessage": "Reboot Countdown usermessage",
            "description": "Reboot Countdown description"
        },
        "onComplete": {
            "userMessage": "On complete userMessage",
            "description": "On complete Description"
        }
    },
    "description": "Winodws job created via public API",
    "createdBy": {
        "user": {
            "id": "ea9067e4-1c28-e208-80b4-312b7a0449cf",
            "name": "gtham_bw"
        },
        "date": 1645970995557
    },
    "updatedBy": {
        "user": null,
        "date": null
    },
    "deletedBy": {
        "user": null,
        "date": null
    },
    "assetCount": null,
    "opportunisticDownloads": true,
    "filterType": "Any",
    "exclusionFilterType": "Any",
    "taggedAssetCount": 0,
    "minimizeWindow": true,
    "dynamicPatchesQQL": "isSecurity: true",
    "isDynamicPatchesQQL": true,
    "dynamicQQLType": 1,
    "platform": "Windows",
    "continueOnPatchFailure": false,
    "preDeployActions": null,
    "postDeployActions": null,
    "applicableAssetCount": 0,
    "monthlyRecurringType": 1,
    "patchTuesdayPlusXDays": 6,
    "recurringLastDayOfMonth": false,
    "jobCategory": 1,
    "jobTriggerStatus": null,
    "completionPercent": null,
    "totalAssetCount": null,
    "assetResultReceivedCount": null,
    "jobSource": 3,
    "readOnly": false,
    "downloadRandomizeTime": 15,
    "downloadRandomizeTimeUnit": "MINUTES",
    "customPatchURLId": 1004,
    "additionalDynamicPatchesQQL": "vulnerabilities.vulnerability.criticality:CRITICAL",
    "additionalDynamicQQLType": 2
}

Sample - Create a Windows rollback job

API request

curl -X POST
"https://<QualysBaseURL>/pm/v1/deploymentjob" -H "accept: application/json" -H "Authorization: Bearer <<jwt token>>"

Request Body - Specify the inputs to create a uninstall job

-d '{
    "name": "Winodws Public API job 5",
    "description": "Winodws job created via public API",
    "approvedPatches": [
        "ca0d50b1-df21-31ef-aa9b-eec805b3a517",
        "9285e676-6340-3ba7-b124-31d84542c7bf"
    ],
    "assetIds": [
        "bdf79678-e0f3-4c96-9d5c-59b14661ec3f"
    ],
    "assetTagIds": [
        "976d805d-855f-4aa7-8713-b44463f7d081"
    ],
    "matchAllTagIds": [],
    "filterType": "Any",
    "exclusionAssetIds": [
        "e52de00f-8631-4dd5-9ff7-622f3e8d698d"
    ],
    "exclusionFilterType": "Any",
    "exclusionTagIds": [
        "22dcb264-9c2a-4d78-bc55-376396b68a08"
    ],
    "coAuthorUserIds": [
        "568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"
    ],
    "dayOfMonth": null,
    "recurringLastDayOfMonth": false,
    "monthlyRecurringType": 0,
    "patchTuesdayPlusXDays": null,
    "recurringDayOfMonth": null,
    "recurringWeekDayOfMonth": null,
    "recurringWeekDays": "",
    "dynamicPatchesQQL": null,
    "dynamicQQLType": "1",
    "isDynamicPatchesQQL": false,
    "continueOnPatchFailure": false,
    "preDeployment": {
        "deferment": {
            "count": 3,
            "interval": 1,
            "intervalUnit": "HOURS"
        },
        "description": "preDeployment description",
        "userMessage": "preDeployment user message"
    },
    "duringDeployment": {
        "description": "During deployment Description",
        "userMessage": "During deployment userMessage"
    },
    "postDeployment": {
        "onComplete": {
            "description": "On complete Description",
            "userMessage": "On complete userMessage"
        },
        "rebootCountdown": {
            "interval": 15,
            "intervalUnit": "MINUTES",
            "userMessage": "Reboot Countdown usermessage",
            "description": "Reboot Countdown description"
        },
        "rebootOption": {
            "deferment": {
                "count": 3,
                "interval": 1,
                "intervalUnit": "HOURS"
            },
            "description": "rebootOption description",
            "userMessage": "rebootOption user message"
        },
        "suppressReboots": false
    },
    "platform": "Windows",
    "minimizeWindow": "true",
    "type": "Rollback",
    "status": "Disabled",
    "timeout": 6,
    "timeoutUnit": "HOURS",
    "recurring": false,
    "scheduleType": "On-demand",
    "timezone": null,
    "timezoneType": null,
    "startDateTime": null,
    "opportunisticDownloads": false
}'

Response

{
    "customerId": "6f66747e-2800-7fc7-82d4-1ee7cd30c9fc",
    "id": "ec3fb8b4-2df5-467e-8ab4-0cd84aec3382",
    "schemaVersion": "1.0",
    "name": "Winodws Public API job 5",
    "type": "Rollback",
    "status": "Disabled",
    "assetIds": [
        "bdf79678-e0f3-4c96-9d5c-59b14661ec3f"
    ],
    "assetTagIds": [
        "976d805d-855f-4aa7-8713-b44463f7d081"
    ],
    "matchAllTagIds": [],
    "exclusionTagIds": [
        "22dcb264-9c2a-4d78-bc55-376396b68a08"
    ],
    "exclusionAssetIds": [
        "e52de00f-8631-4dd5-9ff7-622f3e8d698d"
    ],
    "coAuthorUserIds": [
        "568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"
    ],
    "approvedPatches": [],
    "disabledPatches": null,
    "patchCount": 0,
    "scheduleType": "On-demand",
    "startDateTime": "2022-2-27 03:04:46 PM",
    "recurring": false,
    "recurringWeekDays": "",
    "dayOfMonth": null,
    "recurringDayOfMonth": null,
    "recurringWeekDayOfMonth": null,
    "timezoneType": "SPECIFIC_TZ",
    "timezone": "UTC",
    "timeout": 6,
    "timeoutUnit": "HOURS",
    "preDeployment": {
        "userMessage": "preDeployment user message",
        "description": "preDeployment description",
        "deferment": {
            "count": 3,
            "interval": 1,
            "intervalUnit": "HOURS"
        }
    },
    "duringDeployment": {
        "userMessage": "During deployment userMessage",
        "description": "During deployment Description"
    },
    "postDeployment": {
        "suppressReboots": false,
        "rebootOption": {
            "userMessage": "rebootOption user message",
            "description": "rebootOption description",
            "deferment": {
                "count": 3,
                "interval": 1,
                "intervalUnit": "HOURS"
            }
        },
        "rebootCountdown": {
            "interval": 15,
            "intervalUnit": "MINUTES",
            "userMessage": "Reboot Countdown usermessage",
            "description": "Reboot Countdown description"
        },
        "onComplete": {
            "userMessage": "On complete userMessage",
            "description": "On complete Description"
        }
    },
    "description": "Winodws job created via public API",
    "createdBy": {
        "user": {
            "id": "ea9067e4-1c28-e208-80b4-312b7a0449cf",
            "name": "gtham_bw"
        },
        "date": 1645974285950
    },
    "updatedBy": {
        "user": null,
        "date": null
    },
    "deletedBy": {
        "user": null,
        "date": null
    },
    "assetCount": null,
    "opportunisticDownloads": false,
    "filterType": "Any",
    "exclusionFilterType": "Any",
    "taggedAssetCount": 0,
    "minimizeWindow": true,
    "dynamicPatchesQQL": null,
    "isDynamicPatchesQQL": false,
    "dynamicQQLType": 1,
    "platform": "Windows",
    "continueOnPatchFailure": false,
    "preDeployActions": null,
    "postDeployActions": null,
    "applicableAssetCount": 0,
    "monthlyRecurringType": null,
    "patchTuesdayPlusXDays": null,
    "recurringLastDayOfMonth": false,
    "jobCategory": 3,
    "jobTriggerStatus": null,
    "completionPercent": null,
    "totalAssetCount": null,
    "assetResultReceivedCount": null,
    "jobSource": 3,
    "readOnly": false
}

Sample - Create a Linux installation job

API request

curl -X POST
"https://<QualysBaseURL</pm/v1/deploymentjob" -H "accept: application/json" -H "Authorization: Bearer <<jwt token>>"

Request Body - Specify the inputs to create a Linux deployment job

{
    "name": "Public API on demand Linux job with patches",
    "description": "Created via public API",
    "approvedPatches": [],
    "assetIds": [
        "0f0266bf-4884-4bf5-9727-c50c9d8fbf78"
    ],
    "assetTagIds": [
        "f81f37b3-a32b-4aa0-a428-12cad6e37db1"
    ],
    "filterType": "Any",
    "exclusionAssetIds": [
        "5f8fd088-0051-0002-1663-005056aa10f0"
    ],
    "exclusionFilterType": "Any",
    "exclusionTagIds": [
        "1de6c626-de40-4dee-81f8-ae022cd9726a"
    ],
    "coAuthorUserIds": [
        "568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"
    ],
    "preDeployment": null,
    "duringDeployment": null,
    "postDeployment": {
        "onComplete": null,
        "rebootCountdown": null,
        "rebootOption": null,
        "suppressReboots": false
    },
    "platform": "Linux",
    "type": "Install",
    "status": "Disabled",
    "timeout": 6,
    "timeoutUnit": "HOURS",
    "recurring": false,
    "scheduleType": "On-demand",
    "opportunisticDownloads": false,
    "notification": {
        "notificationTypes": {
            "email": true
        },
        "notificationConfigs": {
            "recipientEmails": "abc@gmail.com",
            "completedPercentage": "80"
        },
        "notificationEvents": {
            "onJobStart": true,
            "onJobComplete": false
        }
    },
    "linkedJobId": "99ac4e4e-8325-477b-bf98-953fe44820bf",
    "preDeployActions": [
        {
            "action": "Run Script",
            "actionType": "predeploy",
            "params": {
                "actionItem": "S1",
                "timeout": 180
            },
            "script": "bHM=",
            "scriptType": "sh"
        }
    ],
    "postDeployActions": [
        {
            "action": "Run Script",
            "actionType": "postdeploy",
            "params": {
                "actionItem": "S1",
                "timeout": 180
            },
            "script": "bHM=",
            "scriptType": "sh"
        }
    ]
}

Response

{
    "customerId": "bc023fd7-4290-f28f-8181-95a46f519f52",
    "id": "a8b728ad-66a2-4d1e-80a7-ce5c470ac0df",
    "schemaVersion": "1.0",
    "name": "Public API on demand Linux job with patches 1",
    "type": "Install",
    "status": "Disabled",
    "assetIds": [
        "0f0266bf-4884-4bf5-9727-c50c9d8fbf78"
    ],
    "assetTagIds": [
        "f81f37b3-a32b-4aa0-a428-12cad6e37db1"
    ],
    "matchAllTagIds": null,
    "exclusionTagIds": [
        "1de6c626-de40-4dee-81f8-ae022cd9726a"
    ],
    "exclusionAssetIds": [
        "5f8fd088-0051-0002-1663-005056aa10f0"
    ],
    "coAuthorUserIds": [
        "568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"
    ],
    "approvedPatches": [],
    "disabledPatches": null,
    "patchCount": 0,
    "scheduleType": "On-demand",
    "startDateTime": "2022-10-19 09:33:29 AM",
    "recurring": false,
    "recurringWeekDays": null,
    "dayOfMonth": null,
    "recurringDayOfMonth": null,
    "recurringWeekDayOfMonth": null,
    "timezoneType": "SPECIFIC_TZ",
    "timezone": "UTC",
    "timeout": 6,
    "timeoutUnit": "HOURS",
    "preDeployment": {
        "userMessage": "",
        "description": "",
        "deferment": {
            "count": 3,
            "interval": 1,
            "intervalUnit": "HOURS"
        }
    },
    "duringDeployment": {
        "userMessage": "",
        "description": ""
    },
    "postDeployment": {
        "suppressReboots": false,
        "rebootOption": {
            "userMessage": "",
            "description": "",
            "deferment": {
                "count": 3,
                "interval": 1,
                "intervalUnit": "HOURS"
            }
        },
        "rebootCountdown": {
            "interval": 15,
            "intervalUnit": "MINUTES",
            "userMessage": "",
            "description": ""
        },
        "onComplete": {
            "userMessage": "",
            "description": ""
        }
    },
    "description": "Created via public API",
    "createdBy": {
        "user": {
            "id": "c4c71f94-4ef6-7e6f-8260-11704fa58172",
            "name": "qxxxs_rxx7"
        },
        "date": 1666172001492
    },
    "updatedBy": {
        "user": null,
        "date": null
    },
    "deletedBy": {
        "user": null,
        "date": null
    },
    "assetCount": null,
    "opportunisticDownloads": false,
    "filterType": "Any",
    "exclusionFilterType": "Any",
    "taggedAssetCount": 0,
    "minimizeWindow": null,
    "dynamicPatchesQQL": null,
    "isDynamicPatchesQQL": null,
    "dynamicQQLType": null,
    "platform": "Linux",
    "continueOnPatchFailure": false,
    "preDeployActions": [
        {
            "action": "Run Script",
            "actionId": "2cf190a9-086d-47f9-898f-aed4b98dea5a",
            "actionType": "predeploy",
            "params": {
                "actionItem": "S1",
                "timeout": 180
            },
            "script": "bc023fd7-4290-f28f-8181-95a46f519f52/2cf190a9-086d-47f9-898f-aed4b98dea5a/Script",
            "scriptType": "sh"
        }
    ],
    "postDeployActions": [
        {
            "action": "Run Script",
            "actionId": "b52fc1b1-f598-4e6b-90d8-23bfa94b41fe",
            "actionType": "postdeploy",
            "params": {
                "actionItem": "S1",
                "timeout": 180
            },
            "script": "bc023fd7-4290-f28f-8181-95a46f519f52/b52fc1b1-f598-4e6b-90d8-23bfa94b41fe/Script",
            "scriptType": "ps"
        }
    ],
    "applicableAssetCount": 0,
    "monthlyRecurringType": null,
    "patchTuesdayPlusXDays": null,
    "recurringLastDayOfMonth": null,
    "jobCategory": 3,
    "jobTriggerStatus": null,
    "completionPercent": null,
    "totalAssetCount": null,
    "assetResultReceivedCount": null,
    "jobSource": 3,
    "readOnly": false,
    "notification": {
        "notificationTypes": {
            "email": true
        },
        "notificationConfigs": {
            "recipientEmails": "abc@gmail.com",
            "completedPercentage": "80"
        },
        "notificationEvents": {
            "onJobStart": true,
            "onJobComplete": false
        }
    },
    "linkedJobId": "99ac4e4e-8325-477b-bf98-953fe44820bf",
    "linkedToJob": [
        {
            "customerId": "bc023fd7-4290-f28f-8181-95a46f519f52",
            "id": "99ac4e4e-8325-477b-bf98-953fe44820bf",
            "name": "Linux testing job",
            "type": "Install",
            "status": "Disabled",
            "createdBy": {
                "user": {
                    "id": "c4c71f94-4ef6-7e6f-8260-11704fa58172",
                    "name": "qxxxs_rxx7"
                },
                "date": 1665656673543
            },
            "linkedJobReferenceCount": 2,
            "schedule": "On-Demand",
            "previousRun": null,
            "nextRun": null
        }
    ],
    "linkedJobs": null,
    "downloadRandomizeTime": 0,
    "downloadRandomizeTimeUnit": "MINUTES"
}

Sample - Create a Linux Deployment Job with MakeCache Pre-Action

API Request

curl -X POST "<qualys_base_url>/pm/v1/deploymentjob"
-H "accept: application/json"
-H "Authorization: Bearer <<jwt token>>"

Request Body

{
    "approvedPatches": [],
    "dynamicPatchesQQL": "",
    "isDynamicPatchesQQL": false,
    "additionalDynamicPatchesQQL": "",
    "additionalDynamicQQLType": "",
    "dynamicQQLType": 1,
    "linkedJobId": "",
    "assetIds": [
        "08a028e6-7e1d-4dbf-b040-48d9059dee08"
    ],
    "isAssetImported": false,
    "assetFilePath": null,
    "assetTagIds": [],
    "deleted": false,
    "duringDeployment": {
        "userMessage": "",
        "description": ""
    },
    "name": "Demo_MakeCache",
    "description": "",
    "createdBy": null,
    "patchCount": 0,
    "postDeployment": {
        "suppressreboots": false,
        "onComplete": {
            "userMessage": "",
            "description": ""
        }
    },
    "preDeployment": {
        "deferment": {
            "count": 3,
            "interval": 1,
            "intervalUnit": "HOURS"
        },
        "userMessage": "",
        "description": ""
    },
    "recurring": false,
    "dayOfMonth": null,
    "recurringLastDayOfMonth": false,
    "recurringDayOfMonth": null,
    "patchTuesdayPlusXDays": null,
    "monthlyRecurringType": null,
    "recurringWeekDayOfMonth": null,
    "recurringWeekDays": "",
    "scheduleType": "On-demand",
    "schemaVersion": "1.0",
    "startDateTime": null,
    "status": "Enabled",
    "opportunisticDownloads": false,
    "minimizeWindow": false,
    "timeout": -1,
    "timeoutUnit": "HOURS",
    "timezone": null,
    "timezoneType": null,
    "type": "Install",
    "filterType": "Any",
    "exclusionFilterType": "Any",
    "exclusionTagIds": [],
    "matchAllTagIds": [],
    "coAuthorUserIds": [],
    "platform": "Linux",
    "continueOnPatchFailure": false,
    "exclusionAssetIds": [],
    "jobCategory": null,
    "jobSource": 2,
    "preDeployActions": [
        {
            "action": "Run Script",
            "params": {
                "actionItem": "makecache Pre-Action",
                "remediationScope": false,
                "defaultScriptType": "MakeCache"
            },
            "scriptType": "sh",
            "script": ""
        }
    ],
    "postDeployActions": [],
    "notification": null,
    "remediationQids": [],
    "isVulnContext": false,
    "subCategory": "Patch",
    "chainedJobRule": [],
    "hostIsolationConfig": null,
    "quarantineAssetRequestNotification": null
}

API Response

{
  "customerId": "8ac1558c-cbdf-c133-80c6-0fcf7d68e79c",
  "id": "8df80cf0-e24c-4d7c-877f-10700250c906",
  "schemaVersion": "1.0",
  "name": "Demo_MakeCache",
  "type": "Install",
  "status": "Enabled",
  "assetIds": [
    "08a028e6-7e1d-4dbf-b040-48d9059dee08"
  ],
  "assetTagIds": [],
  "matchAllTagIds": [],
  "exclusionTagIds": [],
  "exclusionAssetIds": [],
  "coAuthorUserIds": [],
  "approvedPatches": [],
  "disabledPatches": null,
  "patchCount": 0,
  "scheduleType": "On-demand",
  "startDateTime": "2025-3-19 04:59:17 AM",
  "recurring": false,
  "recurringWeekDays": "",
  "dayOfMonth": null,
  "recurringDayOfMonth": null,
  "recurringWeekDayOfMonth": null,
  "timezoneType": "SPECIFIC_TZ",
  "timezone": "UTC",
  "timeout": -1,
  "timeoutUnit": "HOURS",
  "preDeployment": {
    "userMessage": "",
    "description": "",
    "deferment": {
      "count": 3,
      "interval": 1,
      "intervalUnit": "HOURS"
    }
  },
  "duringDeployment": {
    "userMessage": "",
    "description": ""
  },
  "postDeployment": {
    "suppressReboots": false,
    "rebootHonorOnUserLogin": false,
    "rebootOption": {
      "userMessage": "",
      "description": "",
      "deferment": {
        "count": 3,
        "interval": 1,
        "intervalUnit": "HOURS"
      }
    },
    "rebootCountdown": {
      "interval": 15,
      "intervalUnit": "MINUTES",
      "userMessage": "",
      "description": ""
    },
    "onComplete": {
      "userMessage": "",
      "description": "",
      "alwaysShowCompletedPrompt": false
    }
  },
  "description": "",
  "createdBy": {
    "user": {
      "id": "9ea81ebb-1830-5f23-8389-2921ae95238f",
      "name": "quaysxkm14",
      "fullName": "Karan Mehta"
    },
    "date": 1742360357346
  },
  "updatedBy": {
    "user": null,
    "date": null
  },
  "deletedBy": {
    "user": null,
    "date": null
  },
  "assetCount": null,
  "opportunisticDownloads": false,
  "filterType": "Any",
  "exclusionFilterType": "Any",
  "taggedAssetCount": 0,
  "minimizeWindow": false,
  "dynamicPatchesQQL": "",
  "isDynamicPatchesQQL": false,
  "dynamicQQLType": 1,
  "platform": "Linux",
  "continueOnPatchFailure": false,
  "preDeployActions": [
    {
      "actionId": "926ff25c-e1c4-4613-a446-53268fed1b52",
      "action": "Run Script",
      "actionType": "predeploy",
      "params": {
        "actionItem": "makecache Pre-Action",
        "timeout": 180,
        "remediationScope": false,
        "defaultScriptType": "MakeCache"
      },
      "script": "default/MakeCache/makecache",
      "scriptType": "sh",
      "actionLinkedToJob": false
    }
  ],
  "postDeployActions": null,
  "applicableAssetCount": 1,
  "monthlyRecurringType": null,
  "patchTuesdayPlusXDays": null,
  "recurringLastDayOfMonth": false,
  "jobCategory": 3,
  "jobTriggerStatus": null,
  "completionPercent": null,
  "totalAssetCount": null,
  "assetResultReceivedCount": null,
  "jobSource": 3,
  "readOnly": false,
  "notification": null,
  "linkedJobId": null,
  "linkedToJob": null,
  "linkedJobs": null,
  "jobStartCountdown": null,
  "passwordAction": null,
  "subCategory": "Patch",
  "additionalDynamicQQLType": null,
  "additionalDynamicPatchesQQL": null,
  "downloadRandomizeTime": 0,
  "downloadRandomizeTimeUnit": "MINUTES",
  "customPatchURLId": null,
  "isVulnContext": false,
  "remediationQids": [],
  "isAssetImported": false,
  "hostIsolationConfig": null,
  "quarantineAssetRequestNotification": null,
  "enableReattemptFailedPatches": null,
  "reattemptFailedPatches": null
}

Sample - Create a Linux Rollback job

API request

curl -X POST "<qualys_base_url>/pm/v1/deploymentjob"
-H "accept: application/json"
-H "Authorization: Bearer <<jwt token>>"

Request Body - Specify the inputs to create a Linux rollback job

{
"name": "Public API on demand Linux Rollback job with patches",
"description": "Created via public API",
"approvedPatches": [],
"assetIds": [
"d543e2a2-3860-461f-bd59-d718c31d2344"
],
"assetTagIds": [],
"filterType": "Any",
"exclusionAssetIds": [],
"exclusionFilterType": "Any",
"exclusionTagIds": [],
"coAuthorUserIds": [
"c4c71f94-4ef6-7e6f-8260-11704fa58172"
],
"preDeployment": null,
"duringDeployment": null,
"postDeployment": {
"onComplete": null,
"rebootCountdown": null,
"rebootOption": null,
"suppressReboots": false
},
"platform": "Linux",
"type": "Rollback",
"status": "Disabled",
"timeout": 6,
"timeoutUnit": "HOURS",
"recurring": false,
"scheduleType": "On-demand",
"opportunisticDownloads": false,
"notification": {
"notificationTypes": {
"email": true
},
"notificationConfigs": {
"recipientEmails": "xxx@xxxx.com",
"completedPercentage": "80"
},
"notificationEvents": {
"onJobStart": true,
"onJobComplete": false
}
},
"preDeployActions": [
{
"action": "Run Script",
"actionType": "predeploy",
"params": {
"actionItem": "S1",
"timeout": 180
},
"script": "bHM=",
"scriptType": "sh"
}
],
"postDeployActions": [
{
"action": "Run Script",
"actionType": "postdeploy",
"params": {
"actionItem": "S1",
"timeout": 180
},
"script": "bHM=",
"scriptType": "sh"
}
]
}

Response

{
  "customerId": "bc023fd7-4290-f28f-8181-95a46f519f52",
  "id": "ee2d6bd3-4944-4ea8-a384-c3f44a40b844",
  "schemaVersion": "1.0",
  "name": "Public API on demand Linux Rollback job with patches",
  "type": "Rollback",
  "status": "Disabled",
  "assetIds": [
    "d543e2a2-3860-461f-bd59-d718c31d2344"
  ],
  "assetTagIds": [],
  "matchAllTagIds": null,
  "exclusionTagIds": [],
  "exclusionAssetIds": [],
  "coAuthorUserIds": [
    "c4c71f94-4ef6-7e6f-8260-11704fa58172"
  ],
  "approvedPatches": [],
  "disabledPatches": null,
  "patchCount": 0,
  "scheduleType": "On-demand",
  "startDateTime": "2024-12-31 10:25:52 AM",
  "recurring": false,
  "recurringWeekDays": null,
  "dayOfMonth": null,
  "recurringDayOfMonth": null,
  "recurringWeekDayOfMonth": null,
  "timezoneType": "SPECIFIC_TZ",
  "timezone": "UTC",
  "timeout": 6,
  "timeoutUnit": "HOURS",
  "preDeployment": {
    "userMessage": "",
    "description": "",
    "deferment": {
      "count": 3,
      "interval": 1,
      "intervalUnit": "HOURS"
    }
  },
  "duringDeployment": {
    "userMessage": "",
    "description": ""
  },
  "postDeployment": {
    "suppressReboots": false,
    "rebootHonorOnUserLogin": false,
    "rebootOption": {
      "userMessage": "",
      "description": "",
      "deferment": {
        "count": 3,
        "interval": 1,
        "intervalUnit": "HOURS"
      }
    },
    "rebootCountdown": {
      "interval": 15,
      "intervalUnit": "MINUTES",
      "userMessage": "",
      "description": ""
    },
    "onComplete": {
      "userMessage": "",
      "description": "",
      "alwaysShowCompletedPrompt": false
    }
  },
  "description": "Created via public API",
  "createdBy": {
    "user": {
      "id": "c4c71f94-4ef6-7e6f-8260-11704fa58172",
      "name": "quays_rw17"
    },
    "date": 1735640751819
  },
  "updatedBy": {
    "user": null,
    "date": null
  },
  "deletedBy": {
    "user": null,
    "date": null
  },
  "assetCount": null,
  "opportunisticDownloads": false,
  "filterType": "Any",
  "exclusionFilterType": "Any",
  "taggedAssetCount": 0,
  "minimizeWindow": null,
  "dynamicPatchesQQL": null,
  "isDynamicPatchesQQL": false,
  "dynamicQQLType": null,
  "platform": "Linux",
  "continueOnPatchFailure": false,
  "preDeployActions": [
    {
      "actionId": "b09fef6a-12ea-41af-9152-17005f0828d4",
      "action": "Run Script",
      "actionType": "predeploy",
      "params": {
        "actionItem": "S1",
        "timeout": 180
      },
      "script": "bc023fd7-4290-f28f-8181-95a46f519f52/b09fef6a-12ea-41af-9152-17005f0828d4/Script",
      "scriptType": "sh",
      "actionLinkedToJob": false
    }
  ],
  "postDeployActions": [
    {
      "actionId": "44d1ea6e-0e3e-430d-8793-afdf4992adb0",
      "action": "Run Script",
      "actionType": "postdeploy",
      "params": {
        "actionItem": "S1",
        "timeout": 180
      },
      "script": "bc023fd7-4290-f28f-8181-95a46f519f52/44d1ea6e-0e3e-430d-8793-afdf4992adb0/Script",
      "scriptType": "sh",
      "actionLinkedToJob": false
    }
  ],
  "applicableAssetCount": 1,
  "monthlyRecurringType": null,
  "patchTuesdayPlusXDays": null,
  "recurringLastDayOfMonth": null,
  "jobCategory": 3,
  "jobTriggerStatus": null,
  "completionPercent": null,
  "totalAssetCount": null,
  "assetResultReceivedCount": null,
  "jobSource": 3,
  "readOnly": false,
  "notification": {
    "notificationTypes": {
      "email": true
    },
    "notificationConfigs": {
      "recipientEmails": "xxx@xxxx.com",
      "completedPercentage": "80"
    },
    "notificationEvents": {
      "onJobStart": true,
      "onJobComplete": false
    }
  },
  "linkedJobId": null,
  "linkedToJob": null,
  "linkedJobs": null,
  "jobStartCountdown": null,
  "passwordAction": null,
  "subCategory": "Patch",
  "additionalDynamicQQLType": null,
  "additionalDynamicPatchesQQL": null,
  "downloadRandomizeTime": 0,
  "downloadRandomizeTimeUnit": "MINUTES",
  "customPatchURLId": null,
  "isVulnContext": null,
  "remediationQids": null,
  "isAssetImported": false
}

Sample - Create a Job with patches added from a parent job and show the Patch Job Deployment Completion Pop-Up Window

API request

curl -X POST "<qualys_base_url>/pm/v1/deploymentjob"
-H "accept: application/json"
-H "Authorization: Bearer <<jwt token>>"

Request Body - Specify the inputs to create a Job with patches added from a parent job and show the Patch Job Deployment Completion Pop-Up Window

{
  "name": "Public API job with chained job and alwaysShowCompletedPrompt",
  "description": "Created via public API",
  "approvedPatches": [],
  "assetIds": ["ac66e55a-efc6-4a8d-9f61-00d871572b96"],
  "assetTagIds": ["f81f37b3-a32b-4aa0-a428-12cad6e37db1"],
  "filterType": "Any",
  "exclusionFilterType": "Any",
  "exclusionAssetIds": ["94c0bc01-3b1b-4b4b-84a0-b9fe3c9aebb0"],
  "exclusionTagIds": [ "1de6c626-de40-4dee-81f8-ae022cd9726a"],
  "coAuthorUserIds": ["568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"],
  "preDeployment": null,
  "duringDeployment": {
    "description": "During deployment Description",
    "userMessage": "During deployment userMessage"
  },
  "postDeployment": {
    "onComplete": {
      "alwaysShowCompletedPrompt" : true,
      "description": "On complete Description",
      "userMessage": "On complete userMessage"
    },
    "rebootCountdown": {
      "interval": 15,
      "intervalUnit": "MINUTES",
      "userMessage": "Reboot Countdown usermessage",
      "description": "Reboot Countdown description"
    },
    "rebootOption": {
      "deferment": {
        "count": 3,
        "interval": 1,
        "intervalUnit": "HOURS"
      },
      "description": "rebootOption description",
      "userMessage": "rebootOption user message"
    },
    "suppressReboots": false
  },
  "platform": "Windows",
  "minimizeWindow": "true",
  "type": "Install",
  "status": "Disabled",
  "timeout": 6,
  "timeoutUnit": "HOURS",
  "recurring": false,
  "scheduleType": "On-demand",
  "opportunisticDownloads": false,
  "downloadRandomizeTime": 2,
  "downloadRandomizeTimeUnit": "HOURS",
"linkedJobId": "5b0fd130-52c8-473c-96b1-8f10ea7d4c13",
"chainedJobRule": [
    {
      "field": "postDeployAction",
      "actionIds": [
        "07eed865-d8e2-4cba-9c2a-27eeeef0598a"
      ],
      "threshold": "100",
      "condition": "Post Actions were successfully executed"
    }
  ],
  "notification": {
    "notificationTypes": {
      "email": true
    },
    "notificationConfigs": {
      "recipientEmails": "xxx@xxxx.com",
      "completedPercentage": 80
    },
    "notificationEvents": {
      "onJobStart": true,
      "onJobComplete": false
    }
  },
  "preDeployActions": [
    {
      "action": "Run Script",
      "params": {
        "actionItem": "Notepad detection script"
      },
      "script": "JHc2ND1HZXQtSXRlbVByb3BlcnR5IEhLTE06XFNvZnR3YXJlXFdvdzY0MzJOb2RlXE1pY3Jvc
29mdFxXaW5kb3dzXEN1cnJlbnRWZXJzaW9uXFVuaW5zdGFsbFwqIHwgd2hlcmUtT2JqZWN0IERpc3BsYXlOYW1lIC1
saWtlICdOb3RlUGFkKysqJwokdzMyPUdldC1JdGVtUHJvcGVydHkgSEtMTTpcU29mdHdhcmVcTWljcm9zb2Z0XFdpbmRvd3
NcQ3VycmVudFZlcnNpb25cVW5pbnN0YWxsXCogIHwgd2hlcmUtT2JqZWN0IERpc3BsYXlOYW1lIC1saWtlICdOb3RlUGF
kKysqJwppZiAoJHc2NCAtb3IgJHczMikKewogICAgV3JpdGUtb3V0cHV0ICJOb3RlcGFkKysgaXMgYWxyZWFkeSBpbnN0
YWxsZWQgb24geW91ciBtYWNoaW5lLiIKfQpFbHNlewogICAgV3JpdGUtT3V0cHV0ICJOb3RlcGFkKysgaXMgbm90IGluc
3RhbGxlZCBvbiB5b3VyIG1hY2hpbmUuIgp9IA==",
      "scriptType": "ps"
    }],
  "postDeployActions": [
    {
      "action": "Install Software",
      "params": {
        "actionItem": "Install Notepad",
        "downloadURL": "https://github.com/notepad-plus-plus/notepad-plus-plus/releases
        /download/v8.6.2/npp.7.5.8.Installer.exe",
        "fileChecksum": "613f36bf5e98be7e56b7ea0c678cfb8534077c2ec1cbe839a854dd0a60278ebb",
        "installMethod": 0
      },
      "script": "JHc2ND1HZXQtSXRlbVByb3BlcnR5IEhLTE06XFNvZnR3YXJlXFdvdzY0MzJOb2RlXE1pY3Jvc29mdFxXaW5kb      3dzXEN1cnJlbnRWZXJzaW9uXFVuaW5zdGFsbFwqIHwgd2hlcmUtT2JqZWN0IERpc3BsYXlOYW1lIC1saWtlICdOb3RlUGFkK      ysqJwokdzMyPUdldC1JdGVtUHJvcGVydHkgSEtMTTpcU29mdHdhcmVcTWljcm9zb2Z0XFdpbmRvd3NcQ3VycmVudFZlcnNpb25      cVW5pbnN0YWxsXCogIHwgd2hlcmUtT2JqZWN0IERpc3BsYXlOYW1lIC1saWtlICdOb3RlUGFkKysqJwppZiAoJHc2NCAtb3IgJ      HczMikKewogICAgV3JpdGUtb3V0cHV0ICJOb3RlcGFkKysgaXMgYWxyZWFkeSBpbnN0YWxsZWQgb24geW91ciBtYWNoaW5lLiI
      KfQpFbHNlewogICAgV3JpdGUtT3V0cHV0ICJOb3RlcGFkKysgaXMgbm90IGluc3RhbGxlZCBvbiB5b3VyIG1hY2hpbmUuIgp9IA==",
      "scriptType": "ps",
      "detectionScript": "",
      "detectionScriptType": "ps"
    }
  ]
}

Response

{
  "customerId": "bc023fd7-4290-f28f-8181-95a46f519f52",
  "id": "bdc31e33-753e-4a10-a5e0-a74fc551034a",
  "schemaVersion": "1.0",
  "name": "Public API job with chained job and alwaysShowCompletedPrompt",
  "type": "Install",
  "status": "Disabled",
  "assetIds": ["ac66e55a-efc6-4a8d-9f61-00d871572b96"],
  "assetTagIds": ["f81f37b3-a32b-4aa0-a428-12cad6e37db1"],
  "matchAllTagIds": null,
  "exclusionAssetIds": ["94c0bc01-3b1b-4b4b-84a0-b9fe3c9aebb0"],
  "exclusionTagIds": [ "1de6c626-de40-4dee-81f8-ae022cd9726a"],
  "coAuthorUserIds": ["568be9b8-cbbb-47bf-8132-e4f3c2c46e6c"],
  "approvedPatches": [],
  "disabledPatches": null,
  "patchCount": 0,
  "scheduleType": "On-demand",
  "startDateTime": "2024-12-31 10:35:04 AM",
  "recurring": false,
  "recurringWeekDays": null,
  "dayOfMonth": null,
  "recurringDayOfMonth": null,
  "recurringWeekDayOfMonth": null,
  "timezoneType": "SPECIFIC_TZ",
  "timezone": "UTC",
  "timeout": 6,
  "timeoutUnit": "HOURS",
  "preDeployment": {
    "userMessage": "",
    "description": "",
    "deferment": {
      "count": 3,
      "interval": 1,
      "intervalUnit": "HOURS"
    }
  },
  "duringDeployment": {
    "userMessage": "During deployment userMessage",
    "description": "During deployment Description"
  },
  "postDeployment": {
    "suppressReboots": false,
    "rebootHonorOnUserLogin": false,
    "rebootOption": {
      "userMessage": "rebootOption user message",
      "description": "rebootOption description",
      "deferment": {
        "count": 3,
        "interval": 1,
        "intervalUnit": "HOURS"
      }
    },
    "rebootCountdown": {
      "interval": 15,
      "intervalUnit": "MINUTES",
      "userMessage": "Reboot Countdown usermessage",
      "description": "Reboot Countdown description"
    },
    "onComplete": {
      "userMessage": "On complete userMessage",
      "description": "On complete Description",
      "alwaysShowCompletedPrompt": true
    }
  },
  "description": "Created via public API",
  "createdBy": {
    "user": {
      "id": "c4c71f94-4ef6-7e6f-8260-11704fa58172",
      "name": "quays_rw17"
    },
    "date": 1735641304754
  },
  "updatedBy": {
    "user": null,
    "date": null
  },
  "deletedBy": {
    "user": null,
    "date": null
  },
  "assetCount": null,
  "opportunisticDownloads": false,
  "filterType": "Any",
  "exclusionFilterType": "Any",
  "taggedAssetCount": 0,
  "minimizeWindow": true,
  "dynamicPatchesQQL": null,
  "isDynamicPatchesQQL": false,
  "dynamicQQLType": null,
  "platform": "Windows",
  "continueOnPatchFailure": false,
  "preDeployActions": [
    {
      "actionId": "11689a7c-ff8d-493f-87c8-5babcfaef512",
      "action": "Run Script",
      "actionType": "predeploy",
      "params": {
        "actionItem": "Notepad detection script",
        "timeout": 180
      },
      "script": "bc023fd7-4290-f28f-8181-95a46f519f52/11689a7c-ff8d-493f-87c8-5babcfaef512/Script",
      "scriptType": "ps",
      "actionLinkedToJob": false
    }
  ],
  "postDeployActions": [
    {
      "actionId": "733d3f6c-8ba4-4ba5-8a54-a57e8a264f11",
      "action": "Install Software",
      "actionType": "postdeploy",
      "params": {
        "actionItem": "Install Notepad",
        "downloadURL": "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.6.2/npp.7.5.8.Installer.exe",
        "downloadProtocol": 0,
        "installMethod": 0,
        "fileChecksum": "613f36bf5e98be7e56b7ea0c678cfb8534077c2ec1cbe839a854dd0a60278ebb",
        "timeout": 180
      },
      "detectionScript": "",
      "detectionScriptType": "ps",
      "script": "bc023fd7-4290-f28f-8181-95a46f519f52/733d3f6c-8ba4-4ba5-8a54-a57e8a264f11/Script",
      "scriptType": "ps",
      "actionLinkedToJob": false
    }
  ],
  "applicableAssetCount": 0,
  "monthlyRecurringType": null,
  "patchTuesdayPlusXDays": null,
  "recurringLastDayOfMonth": null,
  "jobCategory": 3,
  "jobTriggerStatus": null,
  "completionPercent": null,
  "totalAssetCount": null,
  "assetResultReceivedCount": null,
  "jobSource": 3,
  "readOnly": false,
  "notification": {
    "notificationTypes": {
      "email": true
    },
    "notificationConfigs": {
      "recipientEmails": "xxx@xxxx.com",
      "completedPercentage": "80"
    },
    "notificationEvents": {
      "onJobStart": true,
      "onJobComplete": false
    }
  },
  "linkedJobId": "5b0fd130-52c8-473c-96b1-8f10ea7d4c13",
  "linkedToJob": [
    {
      "customerId": "bc023fd7-4290-f28f-8181-95a46f519f52",
      "id": "5b0fd130-52c8-473c-96b1-8f10ea7d4c13",
      "name": "only pre post",
      "type": "Install",
      "status": "Prepared",
      "createdBy": {
        "user": {
          "id": "c4c71f94-4ef6-7e6f-8260-11704fa58172",
          "name": "quays_rw17"
        },
        "date": 1727276515619
      },
      "linkedJobReferenceCount": 3,
      "schedule": "On-Demand",
      "previousRun": null,
      "nextRun": null,
      "chainedJobRule": [
        {
          "id": "c40b7de6-343b-4bf9-80d3-00ee57b2737f",
          "field": "postDeployAction",
          "threshold": 100,
          "actionIds": [
            "07eed865-d8e2-4cba-9c2a-27eeeef0598a"
          ],
          "condition": "Post Actions were successfully executed",
          "actionDetails": [
            {
              "actionId": "07eed865-d8e2-4cba-9c2a-27eeeef0598a",
              "action": "Run Script",
              "actionType": "postdeploy",
              "params": {
                "actionItem": "post",
                "fileChecksum": "",
                "timeout": 180,
                "remediationScope": false
              },
              "script": "bc023fd7-4290-f28f-8181-95a46f519f52/07eed865-d8e2-4cba-9c2a-27eeeef0598a/Script",
              "scriptType": "ps",
              "actionLinkedToJob": false
            }
          ]
        }
      ]
    }
  ],
  "linkedJobs": null,
  "jobStartCountdown": null,
  "passwordAction": null,
  "subCategory": "Patch",
  "additionalDynamicQQLType": null,
  "additionalDynamicPatchesQQL": null,
  "downloadRandomizeTime": 2,
  "downloadRandomizeTimeUnit": "HOURS",
  "customPatchURLId": null,
  "isVulnContext": null,
  "remediationQids": null,
  "isAssetImported": false
}