Qualys Cloud Platform 3.3 (PM) API Notification 1

A new release of Qualys Cloud Platform 3.3 (PM) includes updated APIs, which are targeted for release in January 2025. The specific day will differ depending on the platform. See platform release dates on the Qualys Status page. This API notification provides an early preview into the upcoming API changes, allowing you to identify use cases that can leverage these updated APIs. Additionally, you can decide if the Patch Job Deployment Completion Pop-Up Window should always appear for Windows deployment jobs, regardless of patch deployment status.

What’s New?

In this release, the APIs for creating and updating deployment jobs have been enhanced. You can now create or update rollback jobs for Linux assets, as well as add patches from parent jobs for both Windows and Linux deployments, with conditions based on the parent job’s post-actions.

Updated API: Create a Job

POST /pm/v1/deploymentjob

DTD or XSD changes: Not Applicable

With this release, this API is updated so that you can accomplish the following:

• Create a rollback job to roll back patches from the Linux assets. Earlier you could create a rollback job to roll back patches from only Windows assets.
• Add patches from another job (which you can call a parent or a linked job) while creating Windows and Linux jobs. 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.
• Always show the Patch Job Deployment Completion Pop-Up Window on patched machines for Windows deployment jobs irrespective of whether the patches are failed, skipped, or successfully deployed.

Updated API: Update a Job

PATCH /pm/v1/deploymentjob/update/{deploymentJobId}

DTD or XSD changes: Not Applicable

With this release, this API is updated so that you can accomplish the following:

• Update a rollback job to roll back patches from the Linux assets. Before this release, you could update a rollback job to roll back patches from only Windows assets.
• Add patches from another job (which you can call a parent or a linked job) while updating the Windows and Linux jobs. 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.
• Always show the Patch Job Deployment Completion Pop-Up Window on patched machines for Windows deployment jobs irrespective of whether the patches are failed, skipped, or successfully deployed.

Please refer the release note here for more details: https://docs.qualys.com/en/pm/release-notes/patch_management/release_3_3_api.htm