TaskBlockService

Manages tasks with blocks on the XL Deploy Server.

GET /tasks/v2/current Returns the active tasks of the logged in user.
GET /tasks/v2/current/all Returns all active tasks for all users.
GET /tasks/v2/export Searches for tasks with detailed step information.
GET /tasks/v2/query Searches for archived tasks without step information.
GET /tasks/v2/{taskid} Returns a task by ID.
DELETE /tasks/v2/{taskid} Cancels a stopped task.
POST /tasks/v2/{taskid}/abort Aborts an active task.
POST /tasks/v2/{taskid}/add-pause/{stepPath} Add a pause step at the specified position.
POST /tasks/v2/{taskid}/archive Archive an executed task.
POST /tasks/v2/{taskid}/assign/{owner} Assigns a task to a different user.
GET /tasks/v2/{taskid}/block/{blockPath} Returns a block by ID.
GET /tasks/v2/{taskid}/block/{blockPath}/step Returns a block with steps by ID.
POST /tasks/v2/{taskid}/schedule Schedules a task.
POST /tasks/v2/{taskid}/skip Indicates that one or more steps should be skipped.
POST /tasks/v2/{taskid}/start Starts a task.
GET /tasks/v2/{taskid}/step/{stepPath} Retrieves information about a step.
POST /tasks/v2/{taskid}/stop Gracefully stops an active task.
POST /tasks/v2/{taskid}/takeover/{owner} Takeover a task from the owner.
POST /tasks/v2/{taskid}/unskip Indicates that one or more steps should no longer be skipped, but executed.

GET /tasks/v2/current

Returns the active tasks of the logged in user.
Response body
List of TaskWithBlock - a list of tasks with blocks.
Content type: application/xml

GET /tasks/v2/current/all

Returns all active tasks for all users. Only allowed for admin.
Response body
List of TaskWithBlock - a list of tasks with blocks.
Content type: application/xml

GET /tasks/v2/export

Searches for tasks with detailed step information.
Permissions
report#view
Parameters
Query begindate LocalDate The first day we want to see tasks from, or null for no such limit.
Query enddate LocalDate The last day we want to see tasks from, or null for no such limit.
Response body
Stream of TaskWithBlock - a list of tasks with step information.
Content type: application/xml

GET /tasks/v2/query

Searches for archived tasks without step information.
Permissions
report#view
Parameters
Query begindate LocalDate The first day we want to see tasks from, or null for no such limit.
Query enddate LocalDate The last day we want to see tasks from, or null for no such limit.
Response body
Stream of TaskWithBlock - a list of tasks.
Content type: application/xml

GET /tasks/v2/{taskid}

Returns a task by ID.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
TaskWithBlock - the task with blocks.
Content type: application/xml

DELETE /tasks/v2/{taskid}

Cancels a stopped task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/abort

Aborts an active task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/add-pause/{stepPath}

Add a pause step at the specified position.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path stepPath String the path of the step
Response body
StepBlockState - a task with full step information.
Content type: application/xml

POST /tasks/v2/{taskid}/archive

Archive an executed task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/assign/{owner}

Assigns a task to a different user.
Permissions
task#assign
Parameters
Path taskid String the ID of the task
Path owner String the name of the user that will be the new owner of the task.
Response body
TaskWithBlock - the task.
Content type: application/xml

GET /tasks/v2/{taskid}/block/{blockPath}

Returns a block by ID.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path blockPath String the ID of the block
Response body
BlockState - the block.
Content type: application/xml

GET /tasks/v2/{taskid}/block/{blockPath}/step

Returns a block with steps by ID.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path blockPath String the ID of the block
Response body
StepBlockState - the block with steps.
Content type: application/xml

POST /tasks/v2/{taskid}/schedule

Schedules a task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Query time DateTime the local time (including the local timezone) when the task should be started by the server.
Response body
Empty

POST /tasks/v2/{taskid}/skip

Indicates that one or more steps should be skipped.
Permissions
task#skip_step
Parameters
Path taskid String the ID of the task
Request body application/xml List of String the paths of the steps to skip
Response body
TaskWithBlock - a task
Content type: application/xml

POST /tasks/v2/{taskid}/start

Starts a task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

GET /tasks/v2/{taskid}/step/{stepPath}

Retrieves information about a step. The call returns a response with status code of 304 (Not Modified) if the step has not been modified since ifModifiedSince , otherwise returns a status code of 200 (OK) and the XML containing a StepState.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Path stepPath String the path of the step in the block tree.
Header If-Modified-Since DateTime the if-modified-since date in RFC 1123 (RFC 822 with 4-digit years) date format.
Response body
StepState - XML containing a StepState if the step has not been modified since ifModifiedSince
Content type: application/xml

POST /tasks/v2/{taskid}/stop

Gracefully stops an active task.
Permissions
Available - only to admin and owner of the task
Parameters
Path taskid String the ID of the task
Response body
Empty

POST /tasks/v2/{taskid}/takeover/{owner}

Takeover a task from the owner. This will re-assign the task to your logged in user. This is the reverse of the #assign(String, String) method, which allows you to re-assign a task.
Permissions
task#takeover
Parameters
Path taskid String the ID of the task to take over
Path owner String the current owner of the task
Response body
TaskWithBlock - the task you took over.
Content type: application/xml

POST /tasks/v2/{taskid}/unskip

Indicates that one or more steps should no longer be skipped, but executed.
Permissions
task#skip_step
Parameters
Path taskid String the ID of the task
Request body application/xml List of String the paths of the steps to unskip
Response body
TaskWithBlock - a task
Content type: application/xml