Cancel Task
patch
/rest/v16/tasks/{taskId}
This endpoint cancels the specified task. This endpoint replaces the '/tasks/{taskId}/actions/cancel' endpoint, which was deprecated in Oracle CPQ 20B.
Request
Path Parameters
-
taskId(required): string
The Task ID
Root Schema : Task Cancel Request Details
Type:
object
Title:
Task Cancel Request Details
Task Cancel Request Details
Show Source
-
status(required):
string
Title:
Cancellation Request
Allowed Values:[ "Cancellation Requested" ]
Response
200 Response
The request was accepted.
Root Schema : task
Type:
Show Source
object
-
category:
object category
-
dateAdded:
string
Title:
Date created
Task creation date -
dateModified:
string
Title:
Date Last Modified
The date of the last task modification -
detailStatus:
object Detail Status
Title:
Detail Status
Detail Status for entities associated with this task -
executionTime:
string
Title:
Execution time
The time the task was executed -
files:
array File list
Title:
File list
List of files associated with this task -
id:
integer
Title:
Task ID
The task ID -
links:
object Reference Links
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable -
name:
string
Title:
Task name
The task name -
result:
string
Title:
Task result
The task result -
status:
string
Title:
Status of task
Task status
Nested Schema : category
Type:
Show Source
object
-
displayValue:
string
Title:
Category display type
-
lookupCode:
string
Title:
Category identifier
Nested Schema : Detail Status
Type:
object
Title:
Detail Status
Detail Status for entities associated with this task
Show Source
-
items:
array Entities Statuses
Title:
Entities Statuses
Statuses for all the entities -
message:
string
Title:
High level message for task.
Nested Schema : File list
Type:
array
Title:
File list
List of files associated with this task
Show Source
Nested Schema : Reference Links
Type:
object
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable
Show Source
-
href:
string
Title:
href
URL to the related object -
rel:
string
Title:
Link
Link relationship to the current object
Nested Schema : Entities Statuses
Type:
array
Title:
Entities Statuses
Statuses for all the entities
Show Source
-
Array of:
object Entity Status
Title:
Entity Status
Entity Status
Nested Schema : Entity Status
Type:
object
Title:
Entity Status
Entity Status
Show Source
-
entity:
string
Title:
Entity Display Name
Entity Display Name -
status:
string
Title:
Entity Status
Entity Status -
summary:
array Summary
Title:
Summary
Summary of message and type for entity
Nested Schema : Summary
Type:
array
Title:
Summary
Summary of message and type for entity
Show Source
-
Array of:
object Summary Details
Title:
Summary Details
Summary Details
Nested Schema : Summary Details
Type:
object
Title:
Summary Details
Summary Details
Show Source
-
level:
string
Title:
Message Level
Message Level -
messages:
array Messages
Title:
Messages
Messages
Nested Schema : Messages
Type:
array
Title:
Messages
Messages
Show Source
-
Array of:
string
Title:
Message
Message
Nested Schema : file
Type:
Show Source
object
-
name:
string
Title:
File name
-
type:
string
Title:
File type
File can be of type plain text, csv etc
404 Response
The task doesn't exist or is not accessible for current user.
409 Response
The task cannot be cancelled. For example, a completed task cannot be cancelled.