v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB

Scheduled Tasks

Update a scheduled task

Update an existing scheduled task. Provide schedule for recurrent tasks or executionTime for one-time tasks.

put/v1/scheduled-tasks/{task-id}

Path parameters

task-idinteger required

Request body

taskHandlerIdstring required

Task handler identifier

schedulestring

Cron-style schedule expression (for recurrent tasks)

parametersstring

Task-specific persistent data

objectIdinteger

Associated NetXMS object ID

commentsstring

Task comments

taskKeystring

Optional task key for identification

disabledboolean

Whether the task should be disabled

Response

Task updated successfully

idinteger

Unique task identifier

taskHandlerIdstring

Task handler identifier

schedulestring

Cron-style schedule expression (for recurrent tasks)

parametersstring

Task-specific persistent data

scheduledExecutionTimestring date-time nullable

Scheduled execution time in ISO 8601 format, or null if not set

lastExecutionTimestring date-time nullable

Last execution time in ISO 8601 format, or null if never executed

recurrentboolean

Whether this is a recurrent (cron-based) task

disabledboolean

Whether the task is disabled

completedboolean

Whether the task has completed

runningboolean

Whether the task is currently running

systemboolean

Whether this is a system task

userIdinteger