Description | Example | Return Message | Group(s)

DeleteTask

HTTP Request Formats

DELETE api/task

DELETE api/task/{taskName}

To specify the schedule the command shall be sent to:

DELETE api/schedule/{scheduleName}/task

DELETE api/schedule/{scheduleName}/task/{taskName}

Description

The DeleteTask REST API command deletes the specified tasks in the schedule.

Parameters

Parameters are only used if the task name is not specified in the HTTP request

JSON ParametersBody FormatDescription
Id"Id" : "Task1"Parameter is a string of a single task name. Wildcards are allowed
IdList"IdList": ["Task1","Task2","Task3"]Parameter is a string of text in single quotes of a comma delimited list of task names. Wildcards are allowed
All"All : "TRUE"Optional boolean will delete all tasks within the schedule
Unassigned"Unassigned" : "TRUE"Optional boolean will remove all single instance tasks that are not assigned. This excludes any parent task definitions (recurring parent or template parent task definitions).

 

Examples

Deletes the task DemoTask1 and DemoTask2 from the active schedule
DELETE api/task

Body:

{

"IdList" : ["DemoTask1", "DemoTask2"]

}

Return Message

If activated, a standard response for a successful HTTP response shall appear.

Group Membership

This command belongs to the following group(s):

Scheduler

Version

12.3