For the complete documentation index, see llms.txt. This page is also available as Markdown.

Workflow Tasks

Cancel workflow task.

post

Cancels the workflow task with the specified ID with a reason. If the given workflow is a subprocess, this method makes sure everything is cancelled from the root process instance. If the given task is not found, this method will assume it already was cancelled without throwing any error.

Authorizations
AuthorizationstringRequired
Path parameters
workflowTaskIdstring · uuidRequired

The ID of the workflow task.

Body
stringOptional
Responses
204

Task successfully canceled.

No content

post/workflowTasks/{workflowTaskId}/canceled

No content

Complete workflow tasks.

post

Completes tasks based on the provided request and returns the following tasks, if the same user is assigned to them.

Authorizations
AuthorizationstringRequired
Body

Parameters of the workflow tasks to be completed.

taskIdsstring · uuid[] · min: 1 · max: 2147483647Required

The list of IDs for tasks that should be completed.

guestUserIdstring · uuidOptionalDeprecated

The ID of the guest user. This property is ignored and will be removed without a replacement.

Responses
200

The following tasks, if the calling user is assigned to them. Empty response otherwise.

application/json

Represents a workflow task.

idstring · uuidRequired

The id of the represented object (entity).

systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
workflowInstanceIdstring · uuidOptional

The UUID of the workflow instance.

keystringOptional

The key.

typestringOptional

The type.

aggregationKeystringOptional

The key for aggregation purposes.

priorityinteger · int32Optional

The priority.

ownerstringOptional

The owner.

createTimeinteger · int64Optional

The create time.

dueDateinteger · int64Optional

The due date.

cancelablebooleanOptional

Whether this workflow task is cancelable or not.

reassignablebooleanOptional

Whether this workflow task is reassignable or not.

formRequiredbooleanOptional

Whether this task requires a form or not.

formKeyAvailablebooleanOptional

Whether this task has form key available or not.

containsActivityStreambooleanOptional

Whether this task contains an activity stream or not.

inErrorbooleanOptional

Whether this task is in error or not.

errorMessagestringOptional

The error message in case this task is in error.

descriptionstringOptional

The description of the workflow task.

titlestringOptional

The title of the task.

post/workflowTasks/completed

Find workflow tasks.

get

Returns the workflow tasks matching given search criteria.

Authorizations
AuthorizationstringRequired
Query parameters
offsetinteger · int32Optional

The first result to retrieve. If not set (offset = 0), results will be retrieved starting from row 0.

Default: 0
limitinteger · int32Optional

The maximum number of results to retrieve. If not set (limit = 0), the default limit will be used. The maximum allowed limit is 1000.

Default: 0
countLimitinteger · int32Optional

Allows to limit the number of elements that will be counted. -1 will count everything and 0 will cause the count to be skipped

Default: -1
businessItemIdstring · uuidOptional

The ID of the business item

businessItemTypestring · enumOptional

The type of the business item

Possible values:
taskIdPhrasestringOptional

The part of the id of the task

workflowTaskUserRelationstring · enumOptional

The type of relation between user and searched tasks. This could be either set to search for all the tasks the user is permitted to view or just those assigned to the user.

Default: ALLPossible values:
businessItemNamestringOptional

The part of the name of the business item.

descriptionstringOptional

The part of the task description.

userIdstring · uuidOptional

The ID of the user for which the tasks need to be returned. If empty, the current logged in user will be used

createDateinteger · int64Optional

The creation date of the task. It is the timestamp (in UTC time standard)

dueDateinteger · int64Optional

The due date of the task. It is the timestamp (in UTC time standard)

titlestringOptional

The title/name of the task.

typestringOptional

The task type.

sortFieldstring · enumOptional

The field on which the results are sorted. On due date by default.

Default: DUE_DATEPossible values:
sortOrderstring · enumOptional

The sorting order.

Default: DESCPossible values:
Responses
200

The paged response with found workflow tasks

application/json
totalinteger · int64Optional

The total number of results.

Example: 1000
offsetinteger · int64Optional

The offset for the results.

Example: 10
limitinteger · int64Optional

The maximum number of results to be returned.

Example: 100
get/workflowTasks
200

The paged response with found workflow tasks

Get task form data.

get

Returns the task form data of the workflow task with the specified ID and form property type.

Authorizations
AuthorizationstringRequired
Path parameters
workflowTaskIdstring · uuidRequired

Workflow task ID.

Query parameters
formPropertyTypestringOptional

Form property type.

Responses
200

Workflow task form data successfully found.

application/json

Represents all task related form data.

formKeystringOptional

The form key.

taskIdstringOptional

The id of the task.

containsActivityStreambooleanOptional

Whether the task form contains a activity stream.

subtitlestringOptional

The subtitle of the task if any.

get/workflowTasks/{workflowTaskId}/taskFormData

Get workflow task.

get

Returns the workflow task with the specified ID. A task will only be returned when the user has the correct permission to view it.

Authorizations
AuthorizationstringRequired
Path parameters
workflowTaskIdstring · uuidRequired

The ID of the workflow task to return.

Responses
200

Workflow task successfully found.

application/json

Represents a workflow task.

idstring · uuidRequired

The id of the represented object (entity).

systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
workflowInstanceIdstring · uuidOptional

The UUID of the workflow instance.

keystringOptional

The key.

typestringOptional

The type.

aggregationKeystringOptional

The key for aggregation purposes.

priorityinteger · int32Optional

The priority.

ownerstringOptional

The owner.

createTimeinteger · int64Optional

The create time.

dueDateinteger · int64Optional

The due date.

cancelablebooleanOptional

Whether this workflow task is cancelable or not.

reassignablebooleanOptional

Whether this workflow task is reassignable or not.

formRequiredbooleanOptional

Whether this task requires a form or not.

formKeyAvailablebooleanOptional

Whether this task has form key available or not.

containsActivityStreambooleanOptional

Whether this task contains an activity stream or not.

inErrorbooleanOptional

Whether this task is in error or not.

errorMessagestringOptional

The error message in case this task is in error.

descriptionstringOptional

The description of the workflow task.

titlestringOptional

The title of the task.

get/workflowTasks/{workflowTaskId}

Reassign task.

post

Reassigns the task with the specified ID to one or more users, groups or roles. Caller needs to provide at least one of the value list for users, groups or roles. If roles are provided then the same number of communities needs to be provided also.

Authorizations
AuthorizationstringRequired
Path parameters
workflowTaskIdstring · uuidRequired

The ID of the workflow task.

Query parameters
usersstring · uuid[]Optional

The user IDs to reassign to.

groupsstring · uuid[]Optional

The group IDs to reassign to.

rolesstring · uuid[]Optional

The role IDs to reassign to.

communitiesstring · uuid[]Optional

The Community IDs of the specified roles to reassign to.

Responses
200

Task successfully reassigned.

No content

post/workflowTasks/{workflowTaskId}/reassign

No content

Last updated

Was this helpful?