Skip to main content

Search Human Tasks

Used to retrieve a list of Human tasks based on the provided search criteria.

note

The invoking user should be a task owner, an ADMIN, or an assignee to the tasks returned.

Input Payload

AttributeDescription
startThe start of the search results list, which is used for pagination.
sizeThe number of search results that should be returned from the specified start.
searchTypeThe user making the search. Supported values:
  • ADMIN
  • INBOX
definitionNamesAn array of Human task definition names.
displayNamesAn array of Human task display names.
taskRefNamesAn array of Human task reference names.
workflowIdsAn array of workflow IDs that contain the Human task.
workflowNamesAn array of workflow names that contain the Human task.
statesThe Human task state. Supported values:
  • PENDING
  • ASSIGNED
  • IN_PROGRESS
  • COMPLETED
  • TIMED_OUT
  • DELETED
taskInputQueryInput data to the Human task.
taskOutputQueryOutput data from the Human task.
fullTextQueryAll data associated with the Human task. This search can be made based on an “AND” and “OR” query.
updateStartTimeThe start range for the Human task execution start time.
updateEndTimeThe end range for the Human task execution start time.
assigneesAn array of assignees.
assignees. userThe assignee’s user ID.
assignees. userTypeThe assignee’s user type. Supported values:
  • Conductor User
  • Conductor Group
  • External User
  • External Group
claimantsAn array of claimants.
claimants. userThe claimant’s user ID.
claimants. userTypeThe claimant's user type. Supported values:
  • Conductor User
  • Conductor Group
  • External User
  • External Group
tip

Use the UI to make searches and you can see the payload sent in the network tab to get sample values for searching.

API Endpoint

POST human/tasks/search

Client SDK Methods

TODO: Coming soon to the SDKs