Update Schedule API
This API is used to update an existing schedule.
Input ParametersInput Parameters
Parameter | Mandatory/ Optional | Data Type | Description | |
---|---|---|---|---|
activate | Optional | Boolean | Provide true to activate the schedule or false to keep it inactive. |
|
assetTags | Optional | List | Provide a list of specific asset tag IDs and UUIDs to include in the schedule. | |
assets | Optional | List | Provide a list of specific asset IDs and UUIDs to include in the schedule. | |
description | Optional | String | Provide a description of the schedule. | |
excludedAssets | Optional | List | Specify a list of assets to exclude from the scheduled script execution. | |
scripts | Mandatory | List | Include details of the scripts to execute with the schedule. | |
id | Mandatory | Long | Provide the ID of the script to be scheduled for execution. | |
title | Mandatory | String | Provide the title of the script to be executed. | |
params | Optional | List | Provide the list of script parameters.
It is mandatory in the case of a parameterized script. |
|
title | Mandatory | String | Provide a title for the schedule. | |
user | Optional | List | Provide details of the user who is scheduling the script. | |
allTagsForAssets Enabled |
Optional | Boolean | Provide true if all tags for that asset are enabled; otherwise, false . |
|
rebootAfter ScriptExecution |
Optional | Boolean | Provide true or false to reboot the asset after the script execution. |
|
rebootDelayIn Seconds |
Optional | Number | Specify the time in seconds after which the asset should reboot. | |
rebootDelayTimeUnit | Optional | String | Specify the time unit for the reboot delay.
Accepted values:
|
|
startDate | Mandatory | Integer | Provide the start date for the schedule. | |
startTime | Mandatory | Integer | Provide the start time for the schedule. | |
scheduleType | Mandatory | String | Provide the schedule type.
Accepted values:
|
|
executionPolicy BypassEnabled |
Optional | Boolean | Provide true to bypass the PowerShell execution policy on Windows hosts and run scripts regardless of the policy. If false , CAR follows the host’s execution policy.
This parameter is applicable only for Windows PowerShell script execution. |
|
shareScript ResultWithFim |
Optional | Boolean | Provide true or false to share the script output with File Integrity Monitoring (FIM). |
Sample: Update a scheduleSample: Update a schedule
API Request
curl -X POST
'<qualys_base_url>/sm/v1/scheduler/124'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer {{authToken}}'
-d '{
"activate": true,
"assetTags": [
{ "UUId": "7bb9c14f-ccd0-49d6...",
"id": 49526479
}
],
"assets": [
{
"UUId": "7bb9c14f-ccd0-49d6...",
"id": 49526617
}
],
"description": "Sample_description",
"excludedAssets": [],
"scripts": [
{
"id": 236773,
"title": "Sample title",
"params": [
{
"key": "xXXxXXXx",
"value": "SGV5IEhpaSAhISBT....",
"mandatory": false
}
]
}
],
"title": "Sample title",
"user": {
"id": "ddf20f3a-cfd3-6fd4...",
"name": "John"
},
"allTagsForAssetsEnabled": false,
"rebootAfterScriptExecution": false,
"rebootDelayInSeconds": null,
"rebootDelayTimeUnit": null,
"startDate": "2025-06-25",
"startTime": "13:37:00",
"scheduleType": "ONE_TIME",
"executionPolicyBypassEnabled": true,
"shareScriptResultWithFim": false
}'
API Response
{
"errorCode": "0",
"message": "Scheduler updated successfully",
"body": "c62f7279-3d05-4cf..."
}