Query user tasks

POST 
/user-tasks/search

Search for user tasks based on given criteria.

Request

application/json

Body

sort object[]
Sort field criteria.
Array [
field stringrequired
The field to sort by.
order SortOrderEnum
Possible values: [ASC, DESC]
Default value: ASC
The order in which to sort the related field.
]
page object

Pagination criteria.

from int32

The index of items to start searching from.

limit int32

The maximum number of items to return in one request.

searchAfter object[]

Items to search after. Correlates to the lastSortValues property of a previous search response.

searchBefore object[]

Items to search before. Correlates to the firstSortValues property of a previous search response.

filter object
User task filter request.
userTaskKey int64
The key for this user task.
state string
Possible values: [CREATED, COMPLETED, CANCELED, FAILED]
The state of the user task.
assignee object
The assignee of the user task.
oneOf
MOD1
string
AdvancedStringFilter
$eq string
Checks for equality with the provided value.
$neq string
Checks for inequality with the provided value.
$exists boolean
Checks if the current property exists.
$in string[]
Checks if the property matches any of the provided values.
$like string
Checks if the property matches the provided like value. Supported wildcard characters depend on the configured search client.
priority object
The priority of the user task.
oneOf
MOD1
integer
AdvancedIntegerFilter
$eq int32
Checks for equality with the provided value.
$neq int32
Checks for inequality with the provided value.
$exists boolean
Checks if the current property exists.
$gt int32
Greater than comparison with the provided value.
$gte int32
Greater than or equal comparison with the provided value.
$lt int32
Lower than comparison with the provided value.
$lte int32
Lower than or equal comparison with the provided value.
$in int32[]
Checks if the property matches any of the provided values.
elementId string
The element ID of the user task.
candidateGroup object
The candidate group for this user task.
oneOf
MOD1
string
AdvancedStringFilter
$eq string
Checks for equality with the provided value.
$neq string
Checks for inequality with the provided value.
$exists boolean
Checks if the current property exists.
$in string[]
Checks if the property matches any of the provided values.
$like string
Checks if the property matches the provided like value. Supported wildcard characters depend on the configured search client.
candidateUser object
The candidate user for this user task.
oneOf
MOD1
string
AdvancedStringFilter
$eq string
Checks for equality with the provided value.
$neq string
Checks for inequality with the provided value.
$exists boolean
Checks if the current property exists.
$in string[]
Checks if the property matches any of the provided values.
$like string
Checks if the property matches the provided like value. Supported wildcard characters depend on the configured search client.
processDefinitionKey int64
The key of the process definition.
processInstanceKey int64
The key of the process instance.
tenantId string
Tenant ID of this user task.
processDefinitionId string
The ID of the process definition.
elementInstanceKey int64
The key of the element instance.
processInstanceVariables object[]
Process Instance variables associated with the user task.
Array [
name string
Name of the variable.
value string
The value of the variable.
]
localVariables object[]
Local variables associated with the user task.
Array [
name string
Name of the variable.
value string
The value of the variable.
]

Responses

200

The user task search result.

application/json

Schema

Schema

page object

Pagination information about the search results.

totalItems int64

Total items matching the criteria.

firstSortValues object[]

The sort values of the first item in the result set. Use this in the searchBefore field of an ensuing request.

lastSortValues object[]

The sort values of the last item in the result set. Use this in the searchAfter field of an ensuing request.

items object[]
The matching user tasks.
Array [
userTaskKey int64
The key of the user task.
name string
The name for this user task.
state string
Possible values: [CREATED, COMPLETED, CANCELED, FAILED]
The state of the user task.
assignee string
The assignee of the user task.
elementId string
The element ID of the user task.
elementInstanceKey int64
The key of the element instance.
candidateGroups string[]
The candidate groups for this user task.
candidateUsers string[]
The candidate users for this user task.
processDefinitionId string
The ID of the process definition.
processDefinitionKey int64
The key of the process definition.
processInstanceKey int64
The key of the process instance.
formKey int64
The key of the form.
creationDate date-time
The creation date of a user task.
completionDate date-time
The completion date of a user task.
followUpDate date-time
The follow date of a user task.
dueDate date-time
The due date of a user task.
tenantId string
Tenant ID of this user task.
externalFormReference string
The external form reference.
processDefinitionVersion int32
The version of the process definition.
customHeaders object
Custom headers for the user task.
property name* string
priority integer
Possible values: <= 100
Default value: 50
The priority of a user task. The higher the value the higher the priority.
]

Example (from schema)

{
  "items": [
    {
      "userTaskKey": 0,
      "name": "string",
      "state": "CREATED",
      "assignee": "string",
      "elementId": "string",
      "elementInstanceKey": 0,
      "candidateGroups": [
        "string"
      ],
      "candidateUsers": [
        "string"
      ],
      "processDefinitionId": "string",
      "processDefinitionKey": 0,
      "processInstanceKey": 0,
      "formKey": 0,
      "creationDate": "2024-12-13T13:19:42.518Z",
      "completionDate": "2024-12-13T13:19:42.518Z",
      "followUpDate": "2024-12-13T13:19:42.518Z",
      "dueDate": "2024-12-13T13:19:42.518Z",
      "tenantId": "string",
      "externalFormReference": "string",
      "processDefinitionVersion": 0,
      "customHeaders": {},
      "priority": 50
    }
  ],
  "page": {
    "totalItems": 0,
    "firstSortValues": [
      {}
    ],
    "lastSortValues": [
      {}
    ]
  }
}

400

The user task search query failed. More details are provided in the response body.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

401

The request lacks valid authentication credentials.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

403

Forbidden. The request is not allowed.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

500

An internal error occurred while processing the request.

application/problem+json

Schema

Schema

type uri

Default value: about:blank

A URI identifying the problem type.

title string

A summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code for this problem.

detail string

An explanation of the problem in more detail.

instance uri

A URI identifying the origin of the problem.

Example (from schema)

{
  "type": "about:blank",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

Loading...