Class TaskApi
java.lang.Object
org.camunda.community.rest.client.api.TaskApi
@Generated(value="org.openapitools.codegen.languages.JavaClientCodegen",
date="2024-06-04T13:43:01.451833574Z[Etc/UTC]")
public class TaskApi
extends Object
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidClaim Claims a task for a specific user.voidClaim Claims a task for a specific user.complete(String id, CompleteTaskDto completeTaskDto) Complete Completes a task and updates process variables.Complete Completes a task and updates process variables.voidcreateTask(TaskDto taskDto) Create Creates a new task.voidcreateTask(TaskDto taskDto, Map<String, String> additionalHeaders) Create Creates a new task.voiddelegateTask(String id, UserIdDto userIdDto) Delegate Delegates a task to another user.voidDelegate Delegates a task to another user.voiddeleteTask(String id) Delete Removes a task by id.voiddeleteTask(String id, Map<String, String> additionalHeaders) Delete Removes a task by id.Get Deployed Form Retrieves the deployed form that is referenced from a given task.getDeployedForm(String id, Map<String, String> additionalHeaders) Get Deployed Form Retrieves the deployed form that is referenced from a given task.Get Form Key Retrieves the form key for a task.Get Form Key Retrieves the form key for a task.getFormVariables(String id, String variableNames, Boolean deserializeValues) Get Task Form Variables Retrieves the form variables for a task.getFormVariables(String id, String variableNames, Boolean deserializeValues, Map<String, String> additionalHeaders) Get Task Form Variables Retrieves the form variables for a task.Get Rendered Form Retrieves the rendered form for a task.getRenderedForm(String id, Map<String, String> additionalHeaders) Get Rendered Form Retrieves the rendered form for a task.Get Retrieves a task by id.Get Retrieves a task by id.Get Task Count By Candidate Group Retrieves the number of tasks for each candidate group.getTaskCountByCandidateGroup(Map<String, String> additionalHeaders) Get Task Count By Candidate Group Retrieves the number of tasks for each candidate group.getTasks(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId, String sortBy, String sortOrder, Integer firstResult, Integer maxResults) Get List Queries for tasks that fulfill a given filter.getTasks(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId, String sortBy, String sortOrder, Integer firstResult, Integer maxResults, Map<String, String> additionalHeaders) Get List Queries for tasks that fulfill a given filter.getTasksCount(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId) Get List Count Retrieves the number of tasks that fulfill a provided filter.getTasksCount(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId, Map<String, String> additionalHeaders) Get List Count Retrieves the number of tasks that fulfill a provided filter.voidhandleBpmnError(String id, TaskBpmnErrorDto taskBpmnErrorDto) Handle BPMN Error Reports a business error in the context of a running task by id.voidhandleBpmnError(String id, TaskBpmnErrorDto taskBpmnErrorDto, Map<String, String> additionalHeaders) Handle BPMN Error Reports a business error in the context of a running task by id.voidhandleEscalation(String id, TaskEscalationDto taskEscalationDto) Handle BPMN Escalation Reports an escalation in the context of a running task by id.voidhandleEscalation(String id, TaskEscalationDto taskEscalationDto, Map<String, String> additionalHeaders) Handle BPMN Escalation Reports an escalation in the context of a running task by id.queryTasks(Integer firstResult, Integer maxResults, TaskQueryDto taskQueryDto) Get List (POST) Queries for tasks that fulfill a given filter.queryTasks(Integer firstResult, Integer maxResults, TaskQueryDto taskQueryDto, Map<String, String> additionalHeaders) Get List (POST) Queries for tasks that fulfill a given filter.queryTasksCount(TaskQueryDto taskQueryDto) Get List Count (POST) Retrieves the number of tasks that fulfill the given filter.queryTasksCount(TaskQueryDto taskQueryDto, Map<String, String> additionalHeaders) Get List Count (POST) Retrieves the number of tasks that fulfill the given filter.voidresolve(String id, CompleteTaskDto completeTaskDto) Resolve Resolves a task and updates execution variables.voidResolve Resolves a task and updates execution variables.voidsetApiClient(ApiClient apiClient) voidsetAssignee(String id, UserIdDto userIdDto) Set Assignee Changes the assignee of a task to a specific user.voidSet Assignee Changes the assignee of a task to a specific user.submit(String id, CompleteTaskDto completeTaskDto) Submit Form Completes a task and updates process variables using a form submit.Submit Form Completes a task and updates process variables using a form submit.voidUnclaim Resets a task's assignee.voidUnclaim Resets a task's assignee.voidupdateTask(String id, TaskDto taskDto) Update Updates a task.voidUpdate Updates a task.
-
Constructor Details
-
TaskApi
public TaskApi() -
TaskApi
-
-
Method Details
-
getApiClient
-
setApiClient
-
claim
Claim Claims a task for a specific user. **Note:** The difference with the [Set Assignee](https://docs.camunda.org/manual/7.21/reference/rest/task/post-assignee/) method is that here a check is performed to see if the task already has a user assigned to it.- Parameters:
id- The id of the task to claim. (required)userIdDto- Provide the id of the user that claims the task. (optional)- Throws:
ApiException- if fails to make API call
-
claim
public void claim(String id, UserIdDto userIdDto, Map<String, String> additionalHeaders) throws ApiExceptionClaim Claims a task for a specific user. **Note:** The difference with the [Set Assignee](https://docs.camunda.org/manual/7.21/reference/rest/task/post-assignee/) method is that here a check is performed to see if the task already has a user assigned to it.- Parameters:
id- The id of the task to claim. (required)userIdDto- Provide the id of the user that claims the task. (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
complete
public Map<String,VariableValueDto> complete(String id, CompleteTaskDto completeTaskDto) throws ApiException Complete Completes a task and updates process variables.- Parameters:
id- The id of the task to complete. (required)completeTaskDto- (optional)- Returns:
- Map<String, VariableValueDto>
- Throws:
ApiException- if fails to make API call
-
complete
public Map<String,VariableValueDto> complete(String id, CompleteTaskDto completeTaskDto, Map<String, String> additionalHeaders) throws ApiExceptionComplete Completes a task and updates process variables.- Parameters:
id- The id of the task to complete. (required)completeTaskDto- (optional)additionalHeaders- additionalHeaders for this call- Returns:
- Map<String, VariableValueDto>
- Throws:
ApiException- if fails to make API call
-
createTask
Create Creates a new task.- Parameters:
taskDto- (optional)- Throws:
ApiException- if fails to make API call
-
createTask
Create Creates a new task.- Parameters:
taskDto- (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
delegateTask
Delegate Delegates a task to another user.- Parameters:
id- The id of the task to delegate. (required)userIdDto- Provide the id of the user that the task should be delegated to. (optional)- Throws:
ApiException- if fails to make API call
-
delegateTask
public void delegateTask(String id, UserIdDto userIdDto, Map<String, String> additionalHeaders) throws ApiExceptionDelegate Delegates a task to another user.- Parameters:
id- The id of the task to delegate. (required)userIdDto- Provide the id of the user that the task should be delegated to. (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
deleteTask
Delete Removes a task by id.- Parameters:
id- The id of the task to be removed. (required)- Throws:
ApiException- if fails to make API call
-
deleteTask
Delete Removes a task by id.- Parameters:
id- The id of the task to be removed. (required)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
getDeployedForm
Get Deployed Form Retrieves the deployed form that is referenced from a given task. For further information please refer to the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/task-forms/#embedded-task-forms).- Parameters:
id- The id of the task to get the deployed form for. (required)- Returns:
- File
- Throws:
ApiException- if fails to make API call
-
getDeployedForm
Get Deployed Form Retrieves the deployed form that is referenced from a given task. For further information please refer to the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/task-forms/#embedded-task-forms).- Parameters:
id- The id of the task to get the deployed form for. (required)additionalHeaders- additionalHeaders for this call- Returns:
- File
- Throws:
ApiException- if fails to make API call
-
getForm
Get Form Key Retrieves the form key for a task. The form key corresponds to the `FormData#formKey` property in the engine. This key can be used to do task-specific form rendering in client applications. Additionally, the context path of the containing process application is returned.- Parameters:
id- The id of the task to retrieve the form for. (required)- Returns:
- FormDto
- Throws:
ApiException- if fails to make API call
-
getForm
Get Form Key Retrieves the form key for a task. The form key corresponds to the `FormData#formKey` property in the engine. This key can be used to do task-specific form rendering in client applications. Additionally, the context path of the containing process application is returned.- Parameters:
id- The id of the task to retrieve the form for. (required)additionalHeaders- additionalHeaders for this call- Returns:
- FormDto
- Throws:
ApiException- if fails to make API call
-
getFormVariables
public Map<String,VariableValueDto> getFormVariables(String id, String variableNames, Boolean deserializeValues) throws ApiException Get Task Form Variables Retrieves the form variables for a task. The form variables take form data specified on the task into account. If form fields are defined, the variable types and default values of the form fields are taken into account.- Parameters:
id- The id of the task to retrieve the variables for. (required)variableNames- A comma-separated list of variable names. Allows restricting the list of requested variables to the variable names in the list. It is best practice to restrict the list of variables to the variables actually required by the form in order to minimize fetching of data. If the query parameter is ommitted all variables are fetched. If the query parameter contains non-existent variable names, the variable names are ignored. (optional)deserializeValues- Determines whether serializable variable values (typically variables that store custom Java objects) should be deserialized on server side (default true). If set to true, a serializable variable will be deserialized on server side and transformed to JSON using [Jackson's](http://jackson.codehaus.org/) POJO/bean property introspection feature. Note that this requires the Java classes of the variable value to be on the REST API's classpath. If set to false, a serializable variable will be returned in its serialized format. For example, a variable that is serialized as XML will be returned as a JSON string containing XML. Note: While true is the default value for reasons of backward compatibility, we recommend setting this parameter to false when developing web applications that are independent of the Java process applications deployed to the engine. (optional, default to true)- Returns:
- Map<String, VariableValueDto>
- Throws:
ApiException- if fails to make API call
-
getFormVariables
public Map<String,VariableValueDto> getFormVariables(String id, String variableNames, Boolean deserializeValues, Map<String, String> additionalHeaders) throws ApiExceptionGet Task Form Variables Retrieves the form variables for a task. The form variables take form data specified on the task into account. If form fields are defined, the variable types and default values of the form fields are taken into account.- Parameters:
id- The id of the task to retrieve the variables for. (required)variableNames- A comma-separated list of variable names. Allows restricting the list of requested variables to the variable names in the list. It is best practice to restrict the list of variables to the variables actually required by the form in order to minimize fetching of data. If the query parameter is ommitted all variables are fetched. If the query parameter contains non-existent variable names, the variable names are ignored. (optional)deserializeValues- Determines whether serializable variable values (typically variables that store custom Java objects) should be deserialized on server side (default true). If set to true, a serializable variable will be deserialized on server side and transformed to JSON using [Jackson's](http://jackson.codehaus.org/) POJO/bean property introspection feature. Note that this requires the Java classes of the variable value to be on the REST API's classpath. If set to false, a serializable variable will be returned in its serialized format. For example, a variable that is serialized as XML will be returned as a JSON string containing XML. Note: While true is the default value for reasons of backward compatibility, we recommend setting this parameter to false when developing web applications that are independent of the Java process applications deployed to the engine. (optional, default to true)additionalHeaders- additionalHeaders for this call- Returns:
- Map<String, VariableValueDto>
- Throws:
ApiException- if fails to make API call
-
getRenderedForm
Get Rendered Form Retrieves the rendered form for a task. This method can be used to get the HTML rendering of a [Generated Task Form](https://docs.camunda.org/manual/7.21/user-guide/task-forms/#generated-task-forms).- Parameters:
id- The id of the task to get the rendered form for. (required)- Returns:
- File
- Throws:
ApiException- if fails to make API call
-
getRenderedForm
Get Rendered Form Retrieves the rendered form for a task. This method can be used to get the HTML rendering of a [Generated Task Form](https://docs.camunda.org/manual/7.21/user-guide/task-forms/#generated-task-forms).- Parameters:
id- The id of the task to get the rendered form for. (required)additionalHeaders- additionalHeaders for this call- Returns:
- File
- Throws:
ApiException- if fails to make API call
-
getTask
Get Retrieves a task by id.- Parameters:
id- The id of the task to be retrieved. (required)- Returns:
- TaskDto
- Throws:
ApiException- if fails to make API call
-
getTask
Get Retrieves a task by id.- Parameters:
id- The id of the task to be retrieved. (required)additionalHeaders- additionalHeaders for this call- Returns:
- TaskDto
- Throws:
ApiException- if fails to make API call
-
getTaskCountByCandidateGroup
Get Task Count By Candidate Group Retrieves the number of tasks for each candidate group.- Returns:
- List<TaskCountByCandidateGroupResultDto>
- Throws:
ApiException- if fails to make API call
-
getTaskCountByCandidateGroup
public List<TaskCountByCandidateGroupResultDto> getTaskCountByCandidateGroup(Map<String, String> additionalHeaders) throws ApiExceptionGet Task Count By Candidate Group Retrieves the number of tasks for each candidate group.- Parameters:
additionalHeaders- additionalHeaders for this call- Returns:
- List<TaskCountByCandidateGroupResultDto>
- Throws:
ApiException- if fails to make API call
-
getTasks
public List<TaskDto> getTasks(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId, String sortBy, String sortOrder, Integer firstResult, Integer maxResults) throws ApiException Get List Queries for tasks that fulfill a given filter. The size of the result set can be retrieved by using the Get Task Count method. **Security Consideration:** There are several query parameters (such as assigneeExpression) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) for custom code in the user guide for details.- Parameters:
taskId- Restrict to task with the given id. (optional)taskIdIn- Restrict to tasks with any of the given ids. (optional)processInstanceId- Restrict to tasks that belong to process instances with the given id. (optional)processInstanceIdIn- Restrict to tasks that belong to process instances with the given ids. (optional)processInstanceBusinessKey- Restrict to tasks that belong to process instances with the given business key. (optional)processInstanceBusinessKeyExpression- Restrict to tasks that belong to process instances with the given business key which is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processInstanceBusinessKeyIn- Restrict to tasks that belong to process instances with one of the give business keys. The keys need to be in a comma-separated list. (optional)processInstanceBusinessKeyLike- Restrict to tasks that have a process instance business key that has the parameter value as a substring. (optional)processInstanceBusinessKeyLikeExpression- Restrict to tasks that have a process instance business key that has the parameter value as a substring and is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processDefinitionId- Restrict to tasks that belong to a process definition with the given id. (optional)processDefinitionKey- Restrict to tasks that belong to a process definition with the given key. (optional)processDefinitionKeyIn- Restrict to tasks that belong to a process definition with one of the given keys. The keys need to be in a comma-separated list. (optional)processDefinitionName- Restrict to tasks that belong to a process definition with the given name. (optional)processDefinitionNameLike- Restrict to tasks that have a process definition name that has the parameter value as a substring. (optional)executionId- Restrict to tasks that belong to an execution with the given id. (optional)caseInstanceId- Restrict to tasks that belong to case instances with the given id. (optional)caseInstanceBusinessKey- Restrict to tasks that belong to case instances with the given business key. (optional)caseInstanceBusinessKeyLike- Restrict to tasks that have a case instance business key that has the parameter value as a substring. (optional)caseDefinitionId- Restrict to tasks that belong to a case definition with the given id. (optional)caseDefinitionKey- Restrict to tasks that belong to a case definition with the given key. (optional)caseDefinitionName- Restrict to tasks that belong to a case definition with the given name. (optional)caseDefinitionNameLike- Restrict to tasks that have a case definition name that has the parameter value as a substring. (optional)caseExecutionId- Restrict to tasks that belong to a case execution with the given id. (optional)activityInstanceIdIn- Only include tasks which belong to one of the passed and comma-separated activity instance ids. (optional)tenantIdIn- Only include tasks which belong to one of the passed and comma-separated tenant ids. (optional)withoutTenantId- Only include tasks which belong to no tenant. Value may only be `true`, as `false` is the default behavior. (optional, default to false)assignee- Restrict to tasks that the given user is assigned to. (optional)assigneeExpression- Restrict to tasks that the user described by the given expression is assigned to. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeLike- Restrict to tasks that have an assignee that has the parameter value as a substring. (optional)assigneeLikeExpression- Restrict to tasks that have an assignee that has the parameter value described by the given expression as a substring. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeIn- Only include tasks which are assigned to one of the passed and comma-separated user ids. (optional)assigneeNotIn- Only include tasks which are not assigned to one of the passed and comma-separated user ids. (optional)owner- Restrict to tasks that the given user owns. (optional)ownerExpression- Restrict to tasks that the user described by the given expression owns. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateGroup- Only include tasks that are offered to the given group. (optional)candidateGroupExpression- Only include tasks that are offered to the group described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateUser- Only include tasks that are offered to the given user or to one of his groups. (optional)candidateUserExpression- Only include tasks that are offered to the user described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)includeAssignedTasks- Also include tasks that are assigned to users in candidate queries. Default is to only include tasks that are not assigned to any user if you query by candidate user or group(s). (optional, default to false)involvedUser- Only include tasks that the given user is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). (optional)involvedUserExpression- Only include tasks that the user described by the given expression is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigned- If set to `true`, restricts the query to all tasks that are assigned. (optional, default to false)unassigned- If set to `true`, restricts the query to all tasks that are unassigned. (optional, default to false)taskDefinitionKey- Restrict to tasks that have the given key. (optional)taskDefinitionKeyIn- Restrict to tasks that have one of the given keys. The keys need to be in a comma-separated list. (optional)taskDefinitionKeyLike- Restrict to tasks that have a key that has the parameter value as a substring. (optional)name- Restrict to tasks that have the given name. (optional)nameNotEqual- Restrict to tasks that do not have the given name. (optional)nameLike- Restrict to tasks that have a name with the given parameter value as substring. (optional)nameNotLike- Restrict to tasks that do not have a name with the given parameter value as substring. (optional)description- Restrict to tasks that have the given description. (optional)descriptionLike- Restrict to tasks that have a description that has the parameter value as a substring. (optional)priority- Restrict to tasks that have the given priority. (optional)maxPriority- Restrict to tasks that have a lower or equal priority. (optional)minPriority- Restrict to tasks that have a higher or equal priority. (optional)dueDate- Restrict to tasks that are due on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.546+0200`. (optional)dueDateExpression- Restrict to tasks that are due on the date described by the given expression. See the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueAfter- Restrict to tasks that are due after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.435+0200`. (optional)dueAfterExpression- Restrict to tasks that are due after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueBefore- Restrict to tasks that are due before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.243+0200`. (optional)dueBeforeExpression- Restrict to tasks that are due before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)withoutDueDate- Only include tasks which have no due date. Value may only be `true`, as `false` is the default behavior. (optional, default to false)followUpDate- Restrict to tasks that have a followUp date on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)followUpDateExpression- Restrict to tasks that have a followUp date on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpAfter- Restrict to tasks that have a followUp date after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.542+0200`. (optional)followUpAfterExpression- Restrict to tasks that have a followUp date after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBefore- Restrict to tasks that have a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.234+0200`. (optional)followUpBeforeExpression- Restrict to tasks that have a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBeforeOrNotExistent- Restrict to tasks that have no followUp date or a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.432+0200`. The typical use case is to query all `active` tasks for a user for a given date. (optional)followUpBeforeOrNotExistentExpression- Restrict to tasks that have no followUp date or a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdOn- Restrict to tasks that were created on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.324+0200`. (optional)createdOnExpression- Restrict to tasks that were created on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdAfter- Restrict to tasks that were created after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)createdAfterExpression- Restrict to tasks that were created after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdBefore- Restrict to tasks that were created before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)createdBeforeExpression- Restrict to tasks that were created before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)updatedAfter- Restrict to tasks that were updated after the given date. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)updatedAfterExpression- Restrict to tasks that were updated after the date described by the given expression. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)delegationState- Restrict to tasks that are in the given delegation state. Valid values are `PENDING` and `RESOLVED`. (optional)candidateGroups- Restrict to tasks that are offered to any of the given candidate groups. Takes a comma-separated list of group names, so for example `developers,support,sales`. (optional)candidateGroupsExpression- Restrict to tasks that are offered to any of the candidate groups described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to `java.util.List` of Strings. (optional)withCandidateGroups- Only include tasks which have a candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateGroups- Only include tasks which have no candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withCandidateUsers- Only include tasks which have a candidate user. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateUsers- Only include tasks which have no candidate users. Value may only be `true`, as `false` is the default behavior. (optional, default to false)active- Only include active tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)suspended- Only include suspended tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)taskVariables- Only include tasks that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)processVariables- Only include tasks that belong to process instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`; `notLike`. `key` and `value` may not contain underscore or comma characters. (optional)caseInstanceVariables- Only include tasks that belong to case instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)variableNamesIgnoreCase- Match all variable names in this query case-insensitively. If set `variableName` and `variablename` are treated as equal. (optional, default to false)variableValuesIgnoreCase- Match all variable values in this query case-insensitively. If set `variableValue` and `variablevalue` are treated as equal. (optional, default to false)parentTaskId- Restrict query to all tasks that are sub tasks of the given task. Takes a task id. (optional)sortBy- Sort the results lexicographically by a given criterion. Must be used in conjunction with the sortOrder parameter. (optional)sortOrder- Sort the results in a given order. Values may be asc for ascending order or desc for descending order. Must be used in conjunction with the sortBy parameter. (optional)firstResult- Pagination of results. Specifies the index of the first result to return. (optional)maxResults- Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left. (optional)- Returns:
- List<TaskDto>
- Throws:
ApiException- if fails to make API call
-
getTasks
public List<TaskDto> getTasks(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId, String sortBy, String sortOrder, Integer firstResult, Integer maxResults, Map<String, String> additionalHeaders) throws ApiExceptionGet List Queries for tasks that fulfill a given filter. The size of the result set can be retrieved by using the Get Task Count method. **Security Consideration:** There are several query parameters (such as assigneeExpression) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) for custom code in the user guide for details.- Parameters:
taskId- Restrict to task with the given id. (optional)taskIdIn- Restrict to tasks with any of the given ids. (optional)processInstanceId- Restrict to tasks that belong to process instances with the given id. (optional)processInstanceIdIn- Restrict to tasks that belong to process instances with the given ids. (optional)processInstanceBusinessKey- Restrict to tasks that belong to process instances with the given business key. (optional)processInstanceBusinessKeyExpression- Restrict to tasks that belong to process instances with the given business key which is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processInstanceBusinessKeyIn- Restrict to tasks that belong to process instances with one of the give business keys. The keys need to be in a comma-separated list. (optional)processInstanceBusinessKeyLike- Restrict to tasks that have a process instance business key that has the parameter value as a substring. (optional)processInstanceBusinessKeyLikeExpression- Restrict to tasks that have a process instance business key that has the parameter value as a substring and is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processDefinitionId- Restrict to tasks that belong to a process definition with the given id. (optional)processDefinitionKey- Restrict to tasks that belong to a process definition with the given key. (optional)processDefinitionKeyIn- Restrict to tasks that belong to a process definition with one of the given keys. The keys need to be in a comma-separated list. (optional)processDefinitionName- Restrict to tasks that belong to a process definition with the given name. (optional)processDefinitionNameLike- Restrict to tasks that have a process definition name that has the parameter value as a substring. (optional)executionId- Restrict to tasks that belong to an execution with the given id. (optional)caseInstanceId- Restrict to tasks that belong to case instances with the given id. (optional)caseInstanceBusinessKey- Restrict to tasks that belong to case instances with the given business key. (optional)caseInstanceBusinessKeyLike- Restrict to tasks that have a case instance business key that has the parameter value as a substring. (optional)caseDefinitionId- Restrict to tasks that belong to a case definition with the given id. (optional)caseDefinitionKey- Restrict to tasks that belong to a case definition with the given key. (optional)caseDefinitionName- Restrict to tasks that belong to a case definition with the given name. (optional)caseDefinitionNameLike- Restrict to tasks that have a case definition name that has the parameter value as a substring. (optional)caseExecutionId- Restrict to tasks that belong to a case execution with the given id. (optional)activityInstanceIdIn- Only include tasks which belong to one of the passed and comma-separated activity instance ids. (optional)tenantIdIn- Only include tasks which belong to one of the passed and comma-separated tenant ids. (optional)withoutTenantId- Only include tasks which belong to no tenant. Value may only be `true`, as `false` is the default behavior. (optional, default to false)assignee- Restrict to tasks that the given user is assigned to. (optional)assigneeExpression- Restrict to tasks that the user described by the given expression is assigned to. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeLike- Restrict to tasks that have an assignee that has the parameter value as a substring. (optional)assigneeLikeExpression- Restrict to tasks that have an assignee that has the parameter value described by the given expression as a substring. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeIn- Only include tasks which are assigned to one of the passed and comma-separated user ids. (optional)assigneeNotIn- Only include tasks which are not assigned to one of the passed and comma-separated user ids. (optional)owner- Restrict to tasks that the given user owns. (optional)ownerExpression- Restrict to tasks that the user described by the given expression owns. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateGroup- Only include tasks that are offered to the given group. (optional)candidateGroupExpression- Only include tasks that are offered to the group described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateUser- Only include tasks that are offered to the given user or to one of his groups. (optional)candidateUserExpression- Only include tasks that are offered to the user described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)includeAssignedTasks- Also include tasks that are assigned to users in candidate queries. Default is to only include tasks that are not assigned to any user if you query by candidate user or group(s). (optional, default to false)involvedUser- Only include tasks that the given user is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). (optional)involvedUserExpression- Only include tasks that the user described by the given expression is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigned- If set to `true`, restricts the query to all tasks that are assigned. (optional, default to false)unassigned- If set to `true`, restricts the query to all tasks that are unassigned. (optional, default to false)taskDefinitionKey- Restrict to tasks that have the given key. (optional)taskDefinitionKeyIn- Restrict to tasks that have one of the given keys. The keys need to be in a comma-separated list. (optional)taskDefinitionKeyLike- Restrict to tasks that have a key that has the parameter value as a substring. (optional)name- Restrict to tasks that have the given name. (optional)nameNotEqual- Restrict to tasks that do not have the given name. (optional)nameLike- Restrict to tasks that have a name with the given parameter value as substring. (optional)nameNotLike- Restrict to tasks that do not have a name with the given parameter value as substring. (optional)description- Restrict to tasks that have the given description. (optional)descriptionLike- Restrict to tasks that have a description that has the parameter value as a substring. (optional)priority- Restrict to tasks that have the given priority. (optional)maxPriority- Restrict to tasks that have a lower or equal priority. (optional)minPriority- Restrict to tasks that have a higher or equal priority. (optional)dueDate- Restrict to tasks that are due on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.546+0200`. (optional)dueDateExpression- Restrict to tasks that are due on the date described by the given expression. See the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueAfter- Restrict to tasks that are due after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.435+0200`. (optional)dueAfterExpression- Restrict to tasks that are due after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueBefore- Restrict to tasks that are due before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.243+0200`. (optional)dueBeforeExpression- Restrict to tasks that are due before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)withoutDueDate- Only include tasks which have no due date. Value may only be `true`, as `false` is the default behavior. (optional, default to false)followUpDate- Restrict to tasks that have a followUp date on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)followUpDateExpression- Restrict to tasks that have a followUp date on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpAfter- Restrict to tasks that have a followUp date after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.542+0200`. (optional)followUpAfterExpression- Restrict to tasks that have a followUp date after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBefore- Restrict to tasks that have a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.234+0200`. (optional)followUpBeforeExpression- Restrict to tasks that have a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBeforeOrNotExistent- Restrict to tasks that have no followUp date or a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.432+0200`. The typical use case is to query all `active` tasks for a user for a given date. (optional)followUpBeforeOrNotExistentExpression- Restrict to tasks that have no followUp date or a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdOn- Restrict to tasks that were created on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.324+0200`. (optional)createdOnExpression- Restrict to tasks that were created on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdAfter- Restrict to tasks that were created after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)createdAfterExpression- Restrict to tasks that were created after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdBefore- Restrict to tasks that were created before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)createdBeforeExpression- Restrict to tasks that were created before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)updatedAfter- Restrict to tasks that were updated after the given date. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)updatedAfterExpression- Restrict to tasks that were updated after the date described by the given expression. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)delegationState- Restrict to tasks that are in the given delegation state. Valid values are `PENDING` and `RESOLVED`. (optional)candidateGroups- Restrict to tasks that are offered to any of the given candidate groups. Takes a comma-separated list of group names, so for example `developers,support,sales`. (optional)candidateGroupsExpression- Restrict to tasks that are offered to any of the candidate groups described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to `java.util.List` of Strings. (optional)withCandidateGroups- Only include tasks which have a candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateGroups- Only include tasks which have no candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withCandidateUsers- Only include tasks which have a candidate user. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateUsers- Only include tasks which have no candidate users. Value may only be `true`, as `false` is the default behavior. (optional, default to false)active- Only include active tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)suspended- Only include suspended tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)taskVariables- Only include tasks that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)processVariables- Only include tasks that belong to process instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`; `notLike`. `key` and `value` may not contain underscore or comma characters. (optional)caseInstanceVariables- Only include tasks that belong to case instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)variableNamesIgnoreCase- Match all variable names in this query case-insensitively. If set `variableName` and `variablename` are treated as equal. (optional, default to false)variableValuesIgnoreCase- Match all variable values in this query case-insensitively. If set `variableValue` and `variablevalue` are treated as equal. (optional, default to false)parentTaskId- Restrict query to all tasks that are sub tasks of the given task. Takes a task id. (optional)sortBy- Sort the results lexicographically by a given criterion. Must be used in conjunction with the sortOrder parameter. (optional)sortOrder- Sort the results in a given order. Values may be asc for ascending order or desc for descending order. Must be used in conjunction with the sortBy parameter. (optional)firstResult- Pagination of results. Specifies the index of the first result to return. (optional)maxResults- Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left. (optional)additionalHeaders- additionalHeaders for this call- Returns:
- List<TaskDto>
- Throws:
ApiException- if fails to make API call
-
getTasksCount
public CountResultDto getTasksCount(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId) throws ApiException Get List Count Retrieves the number of tasks that fulfill a provided filter. Corresponds to the size of the result set when using the [Get Tasks](https://docs.camunda.org/manual/7.21/reference/rest/task/) method. **Security Consideration:** There are several query parameters (such as assigneeExpression) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) for custom code in the user guide for details.- Parameters:
taskId- Restrict to task with the given id. (optional)taskIdIn- Restrict to tasks with any of the given ids. (optional)processInstanceId- Restrict to tasks that belong to process instances with the given id. (optional)processInstanceIdIn- Restrict to tasks that belong to process instances with the given ids. (optional)processInstanceBusinessKey- Restrict to tasks that belong to process instances with the given business key. (optional)processInstanceBusinessKeyExpression- Restrict to tasks that belong to process instances with the given business key which is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processInstanceBusinessKeyIn- Restrict to tasks that belong to process instances with one of the give business keys. The keys need to be in a comma-separated list. (optional)processInstanceBusinessKeyLike- Restrict to tasks that have a process instance business key that has the parameter value as a substring. (optional)processInstanceBusinessKeyLikeExpression- Restrict to tasks that have a process instance business key that has the parameter value as a substring and is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processDefinitionId- Restrict to tasks that belong to a process definition with the given id. (optional)processDefinitionKey- Restrict to tasks that belong to a process definition with the given key. (optional)processDefinitionKeyIn- Restrict to tasks that belong to a process definition with one of the given keys. The keys need to be in a comma-separated list. (optional)processDefinitionName- Restrict to tasks that belong to a process definition with the given name. (optional)processDefinitionNameLike- Restrict to tasks that have a process definition name that has the parameter value as a substring. (optional)executionId- Restrict to tasks that belong to an execution with the given id. (optional)caseInstanceId- Restrict to tasks that belong to case instances with the given id. (optional)caseInstanceBusinessKey- Restrict to tasks that belong to case instances with the given business key. (optional)caseInstanceBusinessKeyLike- Restrict to tasks that have a case instance business key that has the parameter value as a substring. (optional)caseDefinitionId- Restrict to tasks that belong to a case definition with the given id. (optional)caseDefinitionKey- Restrict to tasks that belong to a case definition with the given key. (optional)caseDefinitionName- Restrict to tasks that belong to a case definition with the given name. (optional)caseDefinitionNameLike- Restrict to tasks that have a case definition name that has the parameter value as a substring. (optional)caseExecutionId- Restrict to tasks that belong to a case execution with the given id. (optional)activityInstanceIdIn- Only include tasks which belong to one of the passed and comma-separated activity instance ids. (optional)tenantIdIn- Only include tasks which belong to one of the passed and comma-separated tenant ids. (optional)withoutTenantId- Only include tasks which belong to no tenant. Value may only be `true`, as `false` is the default behavior. (optional, default to false)assignee- Restrict to tasks that the given user is assigned to. (optional)assigneeExpression- Restrict to tasks that the user described by the given expression is assigned to. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeLike- Restrict to tasks that have an assignee that has the parameter value as a substring. (optional)assigneeLikeExpression- Restrict to tasks that have an assignee that has the parameter value described by the given expression as a substring. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeIn- Only include tasks which are assigned to one of the passed and comma-separated user ids. (optional)assigneeNotIn- Only include tasks which are not assigned to one of the passed and comma-separated user ids. (optional)owner- Restrict to tasks that the given user owns. (optional)ownerExpression- Restrict to tasks that the user described by the given expression owns. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateGroup- Only include tasks that are offered to the given group. (optional)candidateGroupExpression- Only include tasks that are offered to the group described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateUser- Only include tasks that are offered to the given user or to one of his groups. (optional)candidateUserExpression- Only include tasks that are offered to the user described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)includeAssignedTasks- Also include tasks that are assigned to users in candidate queries. Default is to only include tasks that are not assigned to any user if you query by candidate user or group(s). (optional, default to false)involvedUser- Only include tasks that the given user is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). (optional)involvedUserExpression- Only include tasks that the user described by the given expression is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigned- If set to `true`, restricts the query to all tasks that are assigned. (optional, default to false)unassigned- If set to `true`, restricts the query to all tasks that are unassigned. (optional, default to false)taskDefinitionKey- Restrict to tasks that have the given key. (optional)taskDefinitionKeyIn- Restrict to tasks that have one of the given keys. The keys need to be in a comma-separated list. (optional)taskDefinitionKeyLike- Restrict to tasks that have a key that has the parameter value as a substring. (optional)name- Restrict to tasks that have the given name. (optional)nameNotEqual- Restrict to tasks that do not have the given name. (optional)nameLike- Restrict to tasks that have a name with the given parameter value as substring. (optional)nameNotLike- Restrict to tasks that do not have a name with the given parameter value as substring. (optional)description- Restrict to tasks that have the given description. (optional)descriptionLike- Restrict to tasks that have a description that has the parameter value as a substring. (optional)priority- Restrict to tasks that have the given priority. (optional)maxPriority- Restrict to tasks that have a lower or equal priority. (optional)minPriority- Restrict to tasks that have a higher or equal priority. (optional)dueDate- Restrict to tasks that are due on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.546+0200`. (optional)dueDateExpression- Restrict to tasks that are due on the date described by the given expression. See the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueAfter- Restrict to tasks that are due after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.435+0200`. (optional)dueAfterExpression- Restrict to tasks that are due after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueBefore- Restrict to tasks that are due before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.243+0200`. (optional)dueBeforeExpression- Restrict to tasks that are due before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)withoutDueDate- Only include tasks which have no due date. Value may only be `true`, as `false` is the default behavior. (optional, default to false)followUpDate- Restrict to tasks that have a followUp date on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)followUpDateExpression- Restrict to tasks that have a followUp date on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpAfter- Restrict to tasks that have a followUp date after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.542+0200`. (optional)followUpAfterExpression- Restrict to tasks that have a followUp date after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBefore- Restrict to tasks that have a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.234+0200`. (optional)followUpBeforeExpression- Restrict to tasks that have a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBeforeOrNotExistent- Restrict to tasks that have no followUp date or a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.432+0200`. The typical use case is to query all `active` tasks for a user for a given date. (optional)followUpBeforeOrNotExistentExpression- Restrict to tasks that have no followUp date or a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdOn- Restrict to tasks that were created on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.324+0200`. (optional)createdOnExpression- Restrict to tasks that were created on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdAfter- Restrict to tasks that were created after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)createdAfterExpression- Restrict to tasks that were created after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdBefore- Restrict to tasks that were created before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)createdBeforeExpression- Restrict to tasks that were created before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)updatedAfter- Restrict to tasks that were updated after the given date. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)updatedAfterExpression- Restrict to tasks that were updated after the date described by the given expression. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)delegationState- Restrict to tasks that are in the given delegation state. Valid values are `PENDING` and `RESOLVED`. (optional)candidateGroups- Restrict to tasks that are offered to any of the given candidate groups. Takes a comma-separated list of group names, so for example `developers,support,sales`. (optional)candidateGroupsExpression- Restrict to tasks that are offered to any of the candidate groups described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to `java.util.List` of Strings. (optional)withCandidateGroups- Only include tasks which have a candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateGroups- Only include tasks which have no candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withCandidateUsers- Only include tasks which have a candidate user. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateUsers- Only include tasks which have no candidate users. Value may only be `true`, as `false` is the default behavior. (optional, default to false)active- Only include active tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)suspended- Only include suspended tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)taskVariables- Only include tasks that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)processVariables- Only include tasks that belong to process instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`; `notLike`. `key` and `value` may not contain underscore or comma characters. (optional)caseInstanceVariables- Only include tasks that belong to case instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)variableNamesIgnoreCase- Match all variable names in this query case-insensitively. If set `variableName` and `variablename` are treated as equal. (optional, default to false)variableValuesIgnoreCase- Match all variable values in this query case-insensitively. If set `variableValue` and `variablevalue` are treated as equal. (optional, default to false)parentTaskId- Restrict query to all tasks that are sub tasks of the given task. Takes a task id. (optional)- Returns:
- CountResultDto
- Throws:
ApiException- if fails to make API call
-
getTasksCount
public CountResultDto getTasksCount(String taskId, String taskIdIn, String processInstanceId, String processInstanceIdIn, String processInstanceBusinessKey, String processInstanceBusinessKeyExpression, String processInstanceBusinessKeyIn, String processInstanceBusinessKeyLike, String processInstanceBusinessKeyLikeExpression, String processDefinitionId, String processDefinitionKey, String processDefinitionKeyIn, String processDefinitionName, String processDefinitionNameLike, String executionId, String caseInstanceId, String caseInstanceBusinessKey, String caseInstanceBusinessKeyLike, String caseDefinitionId, String caseDefinitionKey, String caseDefinitionName, String caseDefinitionNameLike, String caseExecutionId, String activityInstanceIdIn, String tenantIdIn, Boolean withoutTenantId, String assignee, String assigneeExpression, String assigneeLike, String assigneeLikeExpression, String assigneeIn, String assigneeNotIn, String owner, String ownerExpression, String candidateGroup, String candidateGroupExpression, String candidateUser, String candidateUserExpression, Boolean includeAssignedTasks, String involvedUser, String involvedUserExpression, Boolean assigned, Boolean unassigned, String taskDefinitionKey, String taskDefinitionKeyIn, String taskDefinitionKeyLike, String name, String nameNotEqual, String nameLike, String nameNotLike, String description, String descriptionLike, Integer priority, Integer maxPriority, Integer minPriority, String dueDate, String dueDateExpression, String dueAfter, String dueAfterExpression, String dueBefore, String dueBeforeExpression, Boolean withoutDueDate, String followUpDate, String followUpDateExpression, String followUpAfter, String followUpAfterExpression, String followUpBefore, String followUpBeforeExpression, String followUpBeforeOrNotExistent, String followUpBeforeOrNotExistentExpression, String createdOn, String createdOnExpression, String createdAfter, String createdAfterExpression, String createdBefore, String createdBeforeExpression, String updatedAfter, String updatedAfterExpression, String delegationState, String candidateGroups, String candidateGroupsExpression, Boolean withCandidateGroups, Boolean withoutCandidateGroups, Boolean withCandidateUsers, Boolean withoutCandidateUsers, Boolean active, Boolean suspended, String taskVariables, String processVariables, String caseInstanceVariables, Boolean variableNamesIgnoreCase, Boolean variableValuesIgnoreCase, String parentTaskId, Map<String, String> additionalHeaders) throws ApiExceptionGet List Count Retrieves the number of tasks that fulfill a provided filter. Corresponds to the size of the result set when using the [Get Tasks](https://docs.camunda.org/manual/7.21/reference/rest/task/) method. **Security Consideration:** There are several query parameters (such as assigneeExpression) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) for custom code in the user guide for details.- Parameters:
taskId- Restrict to task with the given id. (optional)taskIdIn- Restrict to tasks with any of the given ids. (optional)processInstanceId- Restrict to tasks that belong to process instances with the given id. (optional)processInstanceIdIn- Restrict to tasks that belong to process instances with the given ids. (optional)processInstanceBusinessKey- Restrict to tasks that belong to process instances with the given business key. (optional)processInstanceBusinessKeyExpression- Restrict to tasks that belong to process instances with the given business key which is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processInstanceBusinessKeyIn- Restrict to tasks that belong to process instances with one of the give business keys. The keys need to be in a comma-separated list. (optional)processInstanceBusinessKeyLike- Restrict to tasks that have a process instance business key that has the parameter value as a substring. (optional)processInstanceBusinessKeyLikeExpression- Restrict to tasks that have a process instance business key that has the parameter value as a substring and is described by an expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)processDefinitionId- Restrict to tasks that belong to a process definition with the given id. (optional)processDefinitionKey- Restrict to tasks that belong to a process definition with the given key. (optional)processDefinitionKeyIn- Restrict to tasks that belong to a process definition with one of the given keys. The keys need to be in a comma-separated list. (optional)processDefinitionName- Restrict to tasks that belong to a process definition with the given name. (optional)processDefinitionNameLike- Restrict to tasks that have a process definition name that has the parameter value as a substring. (optional)executionId- Restrict to tasks that belong to an execution with the given id. (optional)caseInstanceId- Restrict to tasks that belong to case instances with the given id. (optional)caseInstanceBusinessKey- Restrict to tasks that belong to case instances with the given business key. (optional)caseInstanceBusinessKeyLike- Restrict to tasks that have a case instance business key that has the parameter value as a substring. (optional)caseDefinitionId- Restrict to tasks that belong to a case definition with the given id. (optional)caseDefinitionKey- Restrict to tasks that belong to a case definition with the given key. (optional)caseDefinitionName- Restrict to tasks that belong to a case definition with the given name. (optional)caseDefinitionNameLike- Restrict to tasks that have a case definition name that has the parameter value as a substring. (optional)caseExecutionId- Restrict to tasks that belong to a case execution with the given id. (optional)activityInstanceIdIn- Only include tasks which belong to one of the passed and comma-separated activity instance ids. (optional)tenantIdIn- Only include tasks which belong to one of the passed and comma-separated tenant ids. (optional)withoutTenantId- Only include tasks which belong to no tenant. Value may only be `true`, as `false` is the default behavior. (optional, default to false)assignee- Restrict to tasks that the given user is assigned to. (optional)assigneeExpression- Restrict to tasks that the user described by the given expression is assigned to. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeLike- Restrict to tasks that have an assignee that has the parameter value as a substring. (optional)assigneeLikeExpression- Restrict to tasks that have an assignee that has the parameter value described by the given expression as a substring. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigneeIn- Only include tasks which are assigned to one of the passed and comma-separated user ids. (optional)assigneeNotIn- Only include tasks which are not assigned to one of the passed and comma-separated user ids. (optional)owner- Restrict to tasks that the given user owns. (optional)ownerExpression- Restrict to tasks that the user described by the given expression owns. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateGroup- Only include tasks that are offered to the given group. (optional)candidateGroupExpression- Only include tasks that are offered to the group described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)candidateUser- Only include tasks that are offered to the given user or to one of his groups. (optional)candidateUserExpression- Only include tasks that are offered to the user described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)includeAssignedTasks- Also include tasks that are assigned to users in candidate queries. Default is to only include tasks that are not assigned to any user if you query by candidate user or group(s). (optional, default to false)involvedUser- Only include tasks that the given user is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). (optional)involvedUserExpression- Only include tasks that the user described by the given expression is involved in. A user is involved in a task if an identity link exists between task and user (e.g., the user is the assignee). See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. (optional)assigned- If set to `true`, restricts the query to all tasks that are assigned. (optional, default to false)unassigned- If set to `true`, restricts the query to all tasks that are unassigned. (optional, default to false)taskDefinitionKey- Restrict to tasks that have the given key. (optional)taskDefinitionKeyIn- Restrict to tasks that have one of the given keys. The keys need to be in a comma-separated list. (optional)taskDefinitionKeyLike- Restrict to tasks that have a key that has the parameter value as a substring. (optional)name- Restrict to tasks that have the given name. (optional)nameNotEqual- Restrict to tasks that do not have the given name. (optional)nameLike- Restrict to tasks that have a name with the given parameter value as substring. (optional)nameNotLike- Restrict to tasks that do not have a name with the given parameter value as substring. (optional)description- Restrict to tasks that have the given description. (optional)descriptionLike- Restrict to tasks that have a description that has the parameter value as a substring. (optional)priority- Restrict to tasks that have the given priority. (optional)maxPriority- Restrict to tasks that have a lower or equal priority. (optional)minPriority- Restrict to tasks that have a higher or equal priority. (optional)dueDate- Restrict to tasks that are due on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.546+0200`. (optional)dueDateExpression- Restrict to tasks that are due on the date described by the given expression. See the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueAfter- Restrict to tasks that are due after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.435+0200`. (optional)dueAfterExpression- Restrict to tasks that are due after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)dueBefore- Restrict to tasks that are due before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.243+0200`. (optional)dueBeforeExpression- Restrict to tasks that are due before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)withoutDueDate- Only include tasks which have no due date. Value may only be `true`, as `false` is the default behavior. (optional, default to false)followUpDate- Restrict to tasks that have a followUp date on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)followUpDateExpression- Restrict to tasks that have a followUp date on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpAfter- Restrict to tasks that have a followUp date after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.542+0200`. (optional)followUpAfterExpression- Restrict to tasks that have a followUp date after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBefore- Restrict to tasks that have a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.234+0200`. (optional)followUpBeforeExpression- Restrict to tasks that have a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)followUpBeforeOrNotExistent- Restrict to tasks that have no followUp date or a followUp date before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.432+0200`. The typical use case is to query all `active` tasks for a user for a given date. (optional)followUpBeforeOrNotExistentExpression- Restrict to tasks that have no followUp date or a followUp date before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdOn- Restrict to tasks that were created on the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.324+0200`. (optional)createdOnExpression- Restrict to tasks that were created on the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdAfter- Restrict to tasks that were created after the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.342+0200`. (optional)createdAfterExpression- Restrict to tasks that were created after the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)createdBefore- Restrict to tasks that were created before the given date. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)createdBeforeExpression- Restrict to tasks that were created before the date described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)updatedAfter- Restrict to tasks that were updated after the given date. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. By [default](https://docs.camunda.org/manual/7.21/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.332+0200`. (optional)updatedAfterExpression- Restrict to tasks that were updated after the date described by the given expression. Every action that fires a [task update event](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle) is considered as updating the task. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to a `java.util.Date` or `org.joda.time.DateTime` object. (optional)delegationState- Restrict to tasks that are in the given delegation state. Valid values are `PENDING` and `RESOLVED`. (optional)candidateGroups- Restrict to tasks that are offered to any of the given candidate groups. Takes a comma-separated list of group names, so for example `developers,support,sales`. (optional)candidateGroupsExpression- Restrict to tasks that are offered to any of the candidate groups described by the given expression. See the [user guide](https://docs.camunda.org/manual/7.21/user-guide/process-engine/expression-language/#internal-context-functions) for more information on available functions. The expression must evaluate to `java.util.List` of Strings. (optional)withCandidateGroups- Only include tasks which have a candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateGroups- Only include tasks which have no candidate group. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withCandidateUsers- Only include tasks which have a candidate user. Value may only be `true`, as `false` is the default behavior. (optional, default to false)withoutCandidateUsers- Only include tasks which have no candidate users. Value may only be `true`, as `false` is the default behavior. (optional, default to false)active- Only include active tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)suspended- Only include suspended tasks. Value may only be `true`, as `false` is the default behavior. (optional, default to false)taskVariables- Only include tasks that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)processVariables- Only include tasks that belong to process instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`; `notLike`. `key` and `value` may not contain underscore or comma characters. (optional)caseInstanceVariables- Only include tasks that belong to case instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form `key_operator_value`. `key` is the variable name, `operator` is the comparison operator to be used and `value` the variable value. **Note**: Values are always treated as String objects on server side. Valid `operator` values are: `eq` - equal to; `neq` - not equal to; `gt` - greater than; `gteq` - greater than or equal to; `lt` - lower than; `lteq` - lower than or equal to; `like`. `key` and `value` may not contain underscore or comma characters. (optional)variableNamesIgnoreCase- Match all variable names in this query case-insensitively. If set `variableName` and `variablename` are treated as equal. (optional, default to false)variableValuesIgnoreCase- Match all variable values in this query case-insensitively. If set `variableValue` and `variablevalue` are treated as equal. (optional, default to false)parentTaskId- Restrict query to all tasks that are sub tasks of the given task. Takes a task id. (optional)additionalHeaders- additionalHeaders for this call- Returns:
- CountResultDto
- Throws:
ApiException- if fails to make API call
-
handleBpmnError
Handle BPMN Error Reports a business error in the context of a running task by id. The error code must be specified to identify the BPMN error handler. See the documentation for [Reporting Bpmn Error](https://docs.camunda.org/manual/7.21/reference/bpmn20/tasks/user-task/#reporting-bpmn-error) in User Tasks.- Parameters:
id- The id of the task a BPMN error is reported for. (required)taskBpmnErrorDto- (optional)- Throws:
ApiException- if fails to make API call
-
handleBpmnError
public void handleBpmnError(String id, TaskBpmnErrorDto taskBpmnErrorDto, Map<String, String> additionalHeaders) throws ApiExceptionHandle BPMN Error Reports a business error in the context of a running task by id. The error code must be specified to identify the BPMN error handler. See the documentation for [Reporting Bpmn Error](https://docs.camunda.org/manual/7.21/reference/bpmn20/tasks/user-task/#reporting-bpmn-error) in User Tasks.- Parameters:
id- The id of the task a BPMN error is reported for. (required)taskBpmnErrorDto- (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
handleEscalation
Handle BPMN Escalation Reports an escalation in the context of a running task by id. The escalation code must be specified to identify the escalation handler. See the documentation for [Reporting Bpmn Escalation](https://docs.camunda.org/manual/7.21/reference/bpmn20/tasks/user-task/#reporting-bpmn-escalation) in User Tasks.- Parameters:
id- The id of the task in which context a BPMN escalation is reported. (required)taskEscalationDto- (optional)- Throws:
ApiException- if fails to make API call
-
handleEscalation
public void handleEscalation(String id, TaskEscalationDto taskEscalationDto, Map<String, String> additionalHeaders) throws ApiExceptionHandle BPMN Escalation Reports an escalation in the context of a running task by id. The escalation code must be specified to identify the escalation handler. See the documentation for [Reporting Bpmn Escalation](https://docs.camunda.org/manual/7.21/reference/bpmn20/tasks/user-task/#reporting-bpmn-escalation) in User Tasks.- Parameters:
id- The id of the task in which context a BPMN escalation is reported. (required)taskEscalationDto- (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
queryTasks
public List<TaskDto> queryTasks(Integer firstResult, Integer maxResults, TaskQueryDto taskQueryDto) throws ApiException Get List (POST) Queries for tasks that fulfill a given filter. This method is slightly more powerful than the [Get Tasks](https://docs.camunda.org/manual/7.21/reference/rest/task/get-query/) method because it allows filtering by multiple process or task variables of types `String`, `Number` or `Boolean`. The size of the result set can be retrieved by using the [Get Task Count (POST)](https://docs.camunda.org/manual/7.21/reference/rest/task/post-query-count/) method. **Security Consideration**: There are several parameters (such as `assigneeExpression`) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations for custom code](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) in the user guide for details.- Parameters:
firstResult- Pagination of results. Specifies the index of the first result to return. (optional)maxResults- Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left. (optional)taskQueryDto- (optional)- Returns:
- List<TaskDto>
- Throws:
ApiException- if fails to make API call
-
queryTasks
public List<TaskDto> queryTasks(Integer firstResult, Integer maxResults, TaskQueryDto taskQueryDto, Map<String, String> additionalHeaders) throws ApiExceptionGet List (POST) Queries for tasks that fulfill a given filter. This method is slightly more powerful than the [Get Tasks](https://docs.camunda.org/manual/7.21/reference/rest/task/get-query/) method because it allows filtering by multiple process or task variables of types `String`, `Number` or `Boolean`. The size of the result set can be retrieved by using the [Get Task Count (POST)](https://docs.camunda.org/manual/7.21/reference/rest/task/post-query-count/) method. **Security Consideration**: There are several parameters (such as `assigneeExpression`) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations for custom code](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) in the user guide for details.- Parameters:
firstResult- Pagination of results. Specifies the index of the first result to return. (optional)maxResults- Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left. (optional)taskQueryDto- (optional)additionalHeaders- additionalHeaders for this call- Returns:
- List<TaskDto>
- Throws:
ApiException- if fails to make API call
-
queryTasksCount
Get List Count (POST) Retrieves the number of tasks that fulfill the given filter. Corresponds to the size of the result set of the [Get Tasks (POST)](https://docs.camunda.org/manual/7.21/reference/rest/task/post-query/) method and takes the same parameters. **Security Consideration**: There are several parameters (such as `assigneeExpression`) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations for custom code](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) in the user guide for details.- Parameters:
taskQueryDto- (optional)- Returns:
- CountResultDto
- Throws:
ApiException- if fails to make API call
-
queryTasksCount
public CountResultDto queryTasksCount(TaskQueryDto taskQueryDto, Map<String, String> additionalHeaders) throws ApiExceptionGet List Count (POST) Retrieves the number of tasks that fulfill the given filter. Corresponds to the size of the result set of the [Get Tasks (POST)](https://docs.camunda.org/manual/7.21/reference/rest/task/post-query/) method and takes the same parameters. **Security Consideration**: There are several parameters (such as `assigneeExpression`) for specifying an EL expression. These are disabled by default to prevent remote code execution. See the section on [security considerations for custom code](https://docs.camunda.org/manual/7.21/user-guide/process-engine/securing-custom-code/) in the user guide for details.- Parameters:
taskQueryDto- (optional)additionalHeaders- additionalHeaders for this call- Returns:
- CountResultDto
- Throws:
ApiException- if fails to make API call
-
resolve
Resolve Resolves a task and updates execution variables. Resolving a task marks that the assignee is done with the task delegated to them, and that it can be sent back to the owner. Can only be executed when the task has been delegated. The assignee will be set to the owner, who performed the delegation.- Parameters:
id- The id of the task to resolve. (required)completeTaskDto- (optional)- Throws:
ApiException- if fails to make API call
-
resolve
public void resolve(String id, CompleteTaskDto completeTaskDto, Map<String, String> additionalHeaders) throws ApiExceptionResolve Resolves a task and updates execution variables. Resolving a task marks that the assignee is done with the task delegated to them, and that it can be sent back to the owner. Can only be executed when the task has been delegated. The assignee will be set to the owner, who performed the delegation.- Parameters:
id- The id of the task to resolve. (required)completeTaskDto- (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
setAssignee
Set Assignee Changes the assignee of a task to a specific user. **Note:** The difference with the [Claim Task](https://docs.camunda.org/manual/7.21/reference/rest/task/post-claim/) method is that this method does not check if the task already has a user assigned to it.- Parameters:
id- The id of the task to set the assignee for. (required)userIdDto- Provide the id of the user that will be the assignee of the task. (optional)- Throws:
ApiException- if fails to make API call
-
setAssignee
public void setAssignee(String id, UserIdDto userIdDto, Map<String, String> additionalHeaders) throws ApiExceptionSet Assignee Changes the assignee of a task to a specific user. **Note:** The difference with the [Claim Task](https://docs.camunda.org/manual/7.21/reference/rest/task/post-claim/) method is that this method does not check if the task already has a user assigned to it.- Parameters:
id- The id of the task to set the assignee for. (required)userIdDto- Provide the id of the user that will be the assignee of the task. (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
submit
public Map<String,VariableValueDto> submit(String id, CompleteTaskDto completeTaskDto) throws ApiException Submit Form Completes a task and updates process variables using a form submit. There are two difference between this method and the `complete` method: * If the task is in state `PENDING` - i.e., has been delegated before, it is not completed but resolved. Otherwise it will be completed. * If the task has Form Field Metadata defined, the process engine will perform backend validation for any form fields which have validators defined. See the [Generated Task Forms](https://docs.camunda.org/manual/7.21/user-guide/task-forms/_index/#generated-task-forms) section of the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/) for more information.- Parameters:
id- The id of the task to submit the form for. (required)completeTaskDto- (optional)- Returns:
- Map<String, VariableValueDto>
- Throws:
ApiException- if fails to make API call
-
submit
public Map<String,VariableValueDto> submit(String id, CompleteTaskDto completeTaskDto, Map<String, String> additionalHeaders) throws ApiExceptionSubmit Form Completes a task and updates process variables using a form submit. There are two difference between this method and the `complete` method: * If the task is in state `PENDING` - i.e., has been delegated before, it is not completed but resolved. Otherwise it will be completed. * If the task has Form Field Metadata defined, the process engine will perform backend validation for any form fields which have validators defined. See the [Generated Task Forms](https://docs.camunda.org/manual/7.21/user-guide/task-forms/_index/#generated-task-forms) section of the [User Guide](https://docs.camunda.org/manual/7.21/user-guide/) for more information.- Parameters:
id- The id of the task to submit the form for. (required)completeTaskDto- (optional)additionalHeaders- additionalHeaders for this call- Returns:
- Map<String, VariableValueDto>
- Throws:
ApiException- if fails to make API call
-
unclaim
Unclaim Resets a task's assignee. If successful, the task is not assigned to a user.- Parameters:
id- The id of the task to unclaim. (required)- Throws:
ApiException- if fails to make API call
-
unclaim
Unclaim Resets a task's assignee. If successful, the task is not assigned to a user.- Parameters:
id- The id of the task to unclaim. (required)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-
updateTask
Update Updates a task.- Parameters:
id- The id of the task to be updated. (required)taskDto- (optional)- Throws:
ApiException- if fails to make API call
-
updateTask
public void updateTask(String id, TaskDto taskDto, Map<String, String> additionalHeaders) throws ApiExceptionUpdate Updates a task.- Parameters:
id- The id of the task to be updated. (required)taskDto- (optional)additionalHeaders- additionalHeaders for this call- Throws:
ApiException- if fails to make API call
-