> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eorion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取计数(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.22/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.22/user-guide/process-engine/securing-custom-code/)
in the user guide for details.



## OpenAPI

````yaml POST /task/count
openapi: 3.0.2
info:
  title: ORION Platform REST API
  description: OpenApi Spec for ORION Camunda Platform REST API.
  version: 7.22.6-ee
  license:
    name: Apache License 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: http://{host}:{port}/{contextPath}
    description: The API server for the default process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
  - url: http://{host}:{port}/{contextPath}/engine/{engineName}
    description: The API server for a named process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
      engineName:
        default: default
  - url: '{url}'
    description: The API server with a custom url
    variables:
      url:
        default: ''
security:
  - basicAuth: []
tags:
  - name: Authorization
  - name: Batch
  - name: Condition
  - name: Decision Definition
  - name: Decision Requirements Definition
  - name: Deployment
  - name: Engine
  - name: Event Subscription
  - name: Execution
  - name: External Task
  - name: Filter
  - name: Group
  - name: Historic Activity Instance
  - name: Historic Batch
  - name: Historic Decision Definition
  - name: Historic Decision Instance
  - name: Historic Decision Requirements Definition
  - name: Historic Detail
  - name: Historic External Task Log
  - name: Historic Identity Link Log
  - name: Historic Incident
  - name: Historic Job Log
  - name: Historic Process Definition
  - name: Historic Process Instance
  - name: Historic Task Instance
  - name: Historic User Operation Log
  - name: Historic Variable Instance
  - name: History Cleanup
  - name: Identity
  - name: Incident
  - name: Job
  - name: Job Definition
  - name: Message
  - name: Metrics
  - name: Migration
  - name: Modification
  - name: Process Definition
  - name: Process Instance
  - name: Signal
  - name: Schema Log
  - name: Task
  - name: Task Attachment
  - name: Task Comment
  - name: Task Identity Link
  - name: Task Local Variable
  - name: Task Variable
  - name: Telemetry
  - name: Tenant
  - name: User
  - name: Variable Instance
  - name: Version
externalDocs:
  description: Find out more about ORION Rest API
  url: https://docs.eorion.com
paths:
  /task/count:
    post:
      tags:
        - Task
      summary: Get List Count (POST)
      description: >-
        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.22/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.22/user-guide/process-engine/securing-custom-code/)

        in the user guide for details.
      operationId: queryTasksCount
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskQueryDto'
            examples:
              example-1:
                summary: POST `/task` Request Body 1
                value:
                  taskVariables:
                    - name: varName
                      value: varValue
                      operator: eq
                    - name: anotherVarName
                      value: 30
                      operator: neq
                  processInstanceBusinessKeyIn: aBusinessKey,anotherBusinessKey
                  assigneeIn: anAssignee,anotherAssignee
                  priority: 10
                  sorting:
                    - sortBy: dueDate
                      sortOrder: asc
                    - sortBy: processVariable
                      sortOrder: desc
                      parameters:
                        variable: orderId
                        type: String
              example-2:
                summary: POST `/task` Request Body 2
                description: >-
                  Logical query: assignee = "John Munda" AND (name = "Approve
                  Invoice" OR priority = 5) AND (suspended = false OR
                  taskDefinitionKey = "approveInvoice")
                value:
                  assignee: John Munda
                  orQueries:
                    - name: Approve Invoice
                      priority: 5
                    - suspended: false
                      taskDefinitionKey: approveInvoice
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResultDto'
              examples:
                example-1:
                  summary: Status 200 response
                  value:
                    count: 1
          description: Request successful.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionDto'
          description: >-
            Returned if some of the query parameters are invalid. See the

            [Introduction](https://docs.camunda.org/manual/7.22/reference/rest/overview/#error-handling)

            for the error response format.
components:
  schemas:
    TaskQueryDto:
      type: object
      description: A Task query which defines a group of Tasks.
      properties:
        taskId:
          type: string
          nullable: true
          description: Restrict to task with the given id.
        taskIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: Restrict to tasks with any of the given ids.
        processInstanceId:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to process instances with the given
            id.
        processInstanceIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Restrict to tasks that belong to process instances with the given
            ids.
        processInstanceBusinessKey:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to process instances with the given
            business key.
        processInstanceBusinessKeyExpression:
          type: string
          nullable: true
          description: >-
            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.22/user-guide/process-engine/expression-language/#internal-context-functions)

            for more information on available functions.
        processInstanceBusinessKeyIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            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.
        processInstanceBusinessKeyLike:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a process instance business key that has
            the parameter 

            value as a substring.
        processInstanceBusinessKeyLikeExpression:
          type: string
          nullable: true
          description: >-
            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.22/user-guide/process-engine/expression-language/#internal-context-functions) 

            for more information on available functions.
        processDefinitionId:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to a process definition with the given
            id.
        processDefinitionKey:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to a process definition with the given
            key.
        processDefinitionKeyIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            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.
        processDefinitionName:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to a process definition with the given
            name.
        processDefinitionNameLike:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a process definition name that has the
            parameter value as 

            a substring.
        executionId:
          type: string
          nullable: true
          description: Restrict to tasks that belong to an execution with the given id.
        caseInstanceId:
          type: string
          nullable: true
          description: Restrict to tasks that belong to case instances with the given id.
        caseInstanceBusinessKey:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to case instances with the given
            business key.
        caseInstanceBusinessKeyLike:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a case instance business key that has
            the parameter value 

            as a substring.
        caseDefinitionId:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to a case definition with the given
            id.
        caseDefinitionKey:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to a case definition with the given
            key.
        caseDefinitionName:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that belong to a case definition with the given
            name.
        caseDefinitionNameLike:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a case definition name that has the
            parameter value as a 

            substring.
        caseExecutionId:
          type: string
          nullable: true
          description: Restrict to tasks that belong to a case execution with the given id.
        activityInstanceIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Only include tasks which belong to one of the passed and
            comma-separated activity 

            instance ids.
        tenantIdIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Only include tasks which belong to one of the passed and
            comma-separated 

            tenant ids.
        withoutTenantId:
          type: boolean
          nullable: true
          default: false
          description: >-
            Only include tasks which belong to no tenant. Value may only be
            `true`, 

            as `false` is the default behavior.
        assignee:
          type: string
          nullable: true
          description: Restrict to tasks that the given user is assigned to.
        assigneeExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that the user described by the given expression is
            assigned to. See the

            [user
            guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/expression-language/#internal-context-functions) 

            for more information on available functions.
        assigneeLike:
          type: string
          nullable: true
          description: |-
            Restrict to tasks that have an assignee that has the parameter 
            value as a substring.
        assigneeLikeExpression:
          type: string
          nullable: true
          description: >-
            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.22/user-guide/process-engine/expression-language/#internal-context-functions) 

            for more information on available functions.
        assigneeIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Only include tasks which are assigned to one of the passed and
            comma-separated user ids.
        assigneeNotIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Only include tasks which are not assigned to one of the passed and
            comma-separated user ids.
        owner:
          type: string
          nullable: true
          description: Restrict to tasks that the given user owns.
        ownerExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that the user described by the given expression
            owns. See the 

            [user
            guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/expression-language/#internal-context-functions) 

            for more information on available functions.
        candidateGroup:
          type: string
          nullable: true
          description: Only include tasks that are offered to the given group.
        candidateGroupLike:
          type: string
          nullable: true
          description: >-
            Only include tasks that are offered to groups that have the
            parameter value as a substring.
        candidateGroupExpression:
          type: string
          nullable: true
          description: >-
            Only include tasks that are offered to the group described by the
            given expression. 

            See the 

            [user
            guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/expression-language/#internal-context-functions) 

            for more information on available functions.
        candidateUser:
          type: string
          nullable: true
          description: >-
            Only include tasks that are offered to the given user or to one of
            his groups.
        candidateUserExpression:
          type: string
          nullable: true
          description: >-
            Only include tasks that are offered to the user described by the
            given expression. 

            See the 

            [user
            guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/expression-language/#internal-context-functions) 

            for more information on available functions.
        includeAssignedTasks:
          type: boolean
          nullable: true
          default: false
          description: >-
            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).
        involvedUser:
          type: string
          nullable: true
          description: >-
            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).
        involvedUserExpression:
          type: string
          nullable: true
          description: >-
            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.22/user-guide/process-engine/expression-language/#internal-context-functions)

            for more information on available functions.
        assigned:
          type: boolean
          nullable: true
          default: false
          description: >-
            If set to `true`, restricts the query to all tasks that are
            assigned.
        unassigned:
          type: boolean
          nullable: true
          default: false
          description: >-
            If set to `true`, restricts the query to all tasks that are
            unassigned.
        taskDefinitionKey:
          type: string
          nullable: true
          description: Restrict to tasks that have the given key.
        taskDefinitionKeyIn:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Restrict to tasks that have one of the given keys. The keys need to
            be in a comma-separated list.
        taskDefinitionKeyLike:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a key that has the parameter value as a
            substring.
        name:
          type: string
          nullable: true
          description: Restrict to tasks that have the given name.
        nameNotEqual:
          type: string
          nullable: true
          description: Restrict to tasks that do not have the given name.
        nameLike:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a name with the given parameter value as
            substring.
        nameNotLike:
          type: string
          nullable: true
          description: |-
            Restrict to tasks that do not have a name with the given parameter
            value as substring.
        description:
          type: string
          nullable: true
          description: Restrict to tasks that have the given description.
        descriptionLike:
          type: string
          nullable: true
          description: |-
            Restrict to tasks that have a description that has the parameter
            value as a substring.
        priority:
          type: integer
          format: int32
          nullable: true
          description: Restrict to tasks that have the given priority.
        maxPriority:
          type: integer
          format: int32
          nullable: true
          description: Restrict to tasks that have a lower or equal priority.
        minPriority:
          type: integer
          format: int32
          nullable: true
          description: Restrict to tasks that have a higher or equal priority.
        dueDate:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that are due on the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        dueDateExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that are due on the date described by the given
            expression. See the

            [user
            guide](https://docs.camunda.org/manual/7.22/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.
        dueAfter:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that are due after the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        dueAfterExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that are due after the date described by the given
            expression.

            See the

            [user
            guide](https://docs.camunda.org/manual/7.22/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.
        dueBefore:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that are due before the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        dueBeforeExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that are due before the date described by the
            given expression.

            See the

            [user
            guide](https://docs.camunda.org/manual/7.22/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.
        withoutDueDate:
          type: boolean
          nullable: true
          default: false
          description: >-
            Only include tasks which have no due date. Value may only be
            `true`, 

            as `false` is the default behavior.
        followUpDate:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that have a followUp date on the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        followUpDateExpression:
          type: string
          nullable: true
          description: >-
            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.22/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.
        followUpAfter:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that have a followUp date after the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        followUpAfterExpression:
          type: string
          nullable: true
          description: >-
            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.22/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.
        followUpBefore:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that have a followUp date before the given date.
            By

            [default](https://docs.camunda.org/manual/7.22/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`.
        followUpBeforeExpression:
          type: string
          nullable: true
          description: >-
            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.22/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.
        followUpBeforeOrNotExistent:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that have no followUp date or a followUp date
            before the given date.

            By
            [default](https://docs.camunda.org/manual/7.22/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.
        followUpBeforeOrNotExistentExpression:
          type: string
          nullable: true
          description: >-
            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.22/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.
        createdOn:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that were created on the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        createdOnExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that were created on the date described by the
            given expression.

            See the

            [user
            guide](https://docs.camunda.org/manual/7.22/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.
        createdAfter:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that were created after the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        createdAfterExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that were created after the date described by the
            given expression.

            See the

            [user
            guide](https://docs.camunda.org/manual/7.22/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.
        createdBefore:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that were created before the given date. By

            [default](https://docs.camunda.org/manual/7.22/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`.
        createdBeforeExpression:
          type: string
          nullable: true
          description: >-
            Restrict to tasks that were created before the date described by the
            given expression.

            See the

            [user
            guide](https://docs.camunda.org/manual/7.22/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.
        updatedAfter:
          type: string
          format: date-time
          nullable: true
          description: >-
            Restrict to tasks that were updated after the given date. Every
            action that fires 

            a [task update
            event](https://docs.camunda.org/manual/7.22/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle)
            is considered as updating the task.

            By
            [default](https://docs.camunda.org/manual/7.22/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`.
        updatedAfterExpression:
          type: string
          nullable: true
          description: >-
            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.22/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.22/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.
        delegationState:
          type: string
          nullable: true
          enum:
            - PENDING
            - RESOLVED
          description: >-
            Restrict to tasks that are in the given delegation state. Valid
            values are

            `PENDING` and `RESOLVED`.
        candidateGroups:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            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`.
        candidateGroupsExpression:
          type: string
          nullable: true
          description: >-
            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.22/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.
        withCandidateGroups:
          type: boolean
          nullable: true
          default: false
          description: >-
            Only include tasks which have a candidate group. Value may only be
            `true`,

            as `false` is the default behavior.
        withoutCandidateGroups:
          type: boolean
          nullable: true
          default: false
          description: >-
            Only include tasks which have no candidate group. Value may only be
            `true`,

            as `false` is the default behavior.
        withCandidateUsers:
          type: boolean
          nullable: true
          default: false
          description: >-
            Only include tasks which have a candidate user. Value may only be
            `true`,

            as `false` is the default behavior.
        withoutCandidateUsers:
          type: boolean
          nullable: true
          default: false
          description: >-
            Only include tasks which have no candidate users. Value may only be
            `true`,

            as `false` is the default behavior.
        active:
          type: boolean
          nullable: true
          default: false
          description: |-
            Only include active tasks. Value may only be `true`, as `false`
            is the default behavior.
        suspended:
          type: boolean
          nullable: true
          default: false
          description: |-
            Only include suspended tasks. Value may only be `true`, as
            `false` is the default behavior.
        taskVariables:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/VariableQueryParameterDto'
          description: >-
            A JSON array to only include tasks that have variables with certain
            values. The

            array consists of JSON objects with three properties `name`,
            `operator` and `value`.

            `name` is the variable name, `operator` is the comparison operator
            to be used and

            `value` the variable value. `value` may be of type `String`,
            `Number` or `Boolean`.


            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.
        processVariables:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/VariableQueryParameterDto'
          description: >-
            A JSON array to only include tasks that belong to a process instance
            with variables

            with certain values. The array consists of JSON objects with three
            properties

            `name`, `operator` and `value`. `name` is the variable name,
            `operator` is the

            comparison operator to be used and `value` the variable value.
            `value` may be of

            type `String`, `Number` or `Boolean`.


            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.
        caseInstanceVariables:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/VariableQueryParameterDto'
          description: >-
            A JSON array to only include tasks that belong to a case instance
            with variables

            with certain values. The array consists of JSON objects with three
            properties

            `name`, `operator` and `value`. `name` is the variable name,
            `operator` is the

            comparison operator to be used and `value` the variable value.
            `value` may be of

            type `String`, `Number` or `Boolean`.


            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.
        variableNamesIgnoreCase:
          type: boolean
          nullable: true
          default: false
          description: |-
            Match all variable names in this query case-insensitively. If set
            `variableName` and `variablename` are treated as equal.
        variableValuesIgnoreCase:
          type: boolean
          nullable: true
          default: false
          description: |-
            Match all variable values in this query case-insensitively. If set
            `variableValue` and `variablevalue` are treated as equal.
        parentTaskId:
          type: string
          nullable: true
          description: >-
            Restrict query to all tasks that are sub tasks of the given task.
            Takes a task id.
        orQueries:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/TaskQueryDto'
          description: >-
            A JSON array of nested task queries with OR semantics. A task
            matches a nested query if it fulfills

            *at least one* of the query's predicates. With multiple nested
            queries, a task must fulfill at least one predicate of *each* query
            ([Conjunctive Normal
            Form](https://en.wikipedia.org/wiki/Conjunctive_normal_form)).


            All task query properties can be used except for: `sorting`,
            `withCandidateGroups`,

            `withoutCandidateGroups`, `withCandidateUsers`,
            `withoutCandidateUsers`


            See the [User
            guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/process-engine-api/#or-queries)

            for more information about OR queries.
        sorting:
          type: array
          nullable: true
          description: Apply sorting of the result
          items:
            type: object
            properties:
              sortBy:
                type: string
                nullable: true
                enum:
                  - instanceId
                  - caseInstanceId
                  - dueDate
                  - executionId
                  - caseExecutionId
                  - assignee
                  - created
                  - lastUpdated
                  - followUpDate
                  - description
                  - id
                  - name
                  - nameCaseInsensitive
                  - priority
                  - processVariable
                  - executionVariable
                  - taskVariable
                  - caseExecutionVariable
                  - caseInstanceVariable
                description: |-
                  Sort the results lexicographically by a given criterion.
                  Must be used in conjunction with the sortOrder parameter.
              sortOrder:
                type: string
                nullable: true
                enum:
                  - asc
                  - desc
                description: >-
                  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.
              parameters:
                $ref: '#/components/schemas/SortTaskQueryParametersDto'
    CountResultDto:
      type: object
      properties:
        count:
          type: integer
          format: int64
          description: The number of matching instances.
    ExceptionDto:
      title: ExceptionDto
      type: object
      properties:
        type:
          type: string
          nullable: true
          description: An exception class indicating the occurred error.
        message:
          type: string
          nullable: true
          description: A detailed message of the error.
        code:
          type: number
          description: >-
            The code allows your client application to identify the error in an
            automated fashion.

            You can look up the meaning of all built-in codes and learn how to
            add custom codes

            in the [User
            Guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/error-handling/#exception-codes).
    VariableQueryParameterDto:
      allOf:
        - type: object
          properties:
            name:
              type: string
              nullable: true
              description: Variable name
        - $ref: '#/components/schemas/ConditionQueryParameterDto'
    SortTaskQueryParametersDto:
      type: object
      description: >-
        Mandatory when `sortBy` is one of the following values:
        `processVariable`, `executionVariable`,

        `taskVariable`, `caseExecutionVariable` or `caseInstanceVariable`. Must
        be a JSON object with the properties

        `variable` and `type` where `variable` is a variable name and `type` is
        the name of a variable value type.
      properties:
        variable:
          type: string
          nullable: true
          description: The name of the variable to sort by.
        type:
          type: string
          nullable: true
          description: The name of the type of the variable value.
    ConditionQueryParameterDto:
      type: object
      properties:
        operator:
          type: string
          nullable: true
          enum:
            - eq
            - neq
            - gt
            - gteq
            - lt
            - lteq
            - like
            - notLike
          description: >-
            Comparison operator to be used. `notLike` is not supported by all
            endpoints.
        value:
          $ref: '#/components/schemas/AnyValue'
    AnyValue:
      description: |-
        Can be any value - string, number, boolean, array or object.
         **Note**: Not every endpoint supports every type.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````