Create a remediation job for devices

post

https://api.controlup.com/compliance/jobs/devices

Creates a remediation job targeting all remediable issues detected on the specified devices.

Body Params

devices

array of strings

required

length ≥ 1

Device IDs to target.

devices*

name

string

Display name for the job. Defaults to a generated name if omitted.

description

string

Optional description for the job.

dry_run

boolean

If true, returns the list of issues that would be targeted without creating the job.

patch_installation_schedule

object

Controls when downloaded patches and vulnerability remediations are installed. Omit this object entirely to install immediately once downloaded.

schedule

object

deprecated

Deprecated alias for patch_installation_schedule. Use patch_installation_schedule instead.

patch_download_schedule

object

Controls when patches and vulnerability remediations are downloaded. Omit this object entirely to download immediately.

misconfig_mitigation_schedule

object

Controls when misconfiguration checks are run. Omit this object entirely to run immediately.

compliance_mitigation_schedule

object

Controls when compliance checks are run. Omit this object entirely to run immediately.

remediation_behavior

object

Controls how applications and the device are handled during remediation.

Responses

200Successful response