---
title: "Search human tasks"
method: POST
path: "/api/human/tasks/search"
tags: ["human-task"]
---

# Search human tasks

`POST /api/human/tasks/search`

## Request body

- HumanTaskSearch
  - `assignees` HumanTaskUser[]
    - `user` string
    - `userType` 'EXTERNAL_USER' | 'EXTERNAL_GROUP' | 'CONDUCTOR_USER' | 'CONDUCTOR_GROUP'
  - `claimants` HumanTaskUser[]
    - `user` string
    - `userType` 'EXTERNAL_USER' | 'EXTERNAL_GROUP' | 'CONDUCTOR_USER' | 'CONDUCTOR_GROUP'
  - `definitionNames` string[]
  - `displayNames` string[]
  - `fullTextQuery` string
  - `searchType` 'ADMIN' | 'INBOX'
  - `size` integer
  - `start` integer
  - `states` string[]
  - `taskInputQuery` string
  - `taskOutputQuery` string
  - `taskRefNames` string[]
  - `updateEndTime` integer
  - `updateStartTime` integer
  - `workflowIds` string[]
  - `workflowNames` string[]

## Response `200`

OK

- HumanTaskSearchResult
  - `hits` integer
  - `pageSizeLimit` integer
  - `results` HumanTaskEntry[]
    - `assignee` HumanTaskUser
      - `user` string
      - `userType` 'EXTERNAL_USER' | 'EXTERNAL_GROUP' | 'CONDUCTOR_USER' | 'CONDUCTOR_GROUP'
    - `claimant` HumanTaskUser
      - `user` string
      - `userType` 'EXTERNAL_USER' | 'EXTERNAL_GROUP' | 'CONDUCTOR_USER' | 'CONDUCTOR_GROUP'
    - `createdBy` string
    - `createdOn` integer
    - `definitionName` string
    - `displayName` string
    - `humanTaskDef` HumanTaskDefinition
      - `assignmentCompletionStrategy` 'LEAVE_OPEN' | 'TERMINATE'
      - `assignments` HumanTaskAssignment[]
        - `assignee` HumanTaskUser
          - `user` string
          - `userType` 'EXTERNAL_USER' | 'EXTERNAL_GROUP' | 'CONDUCTOR_USER' | 'CONDUCTOR_GROUP'
        - `slaMinutes` integer
      - `autoClaim` boolean
      - `displayName` string
      - `fullTemplate` HumanTaskTemplate
        - `createTime` integer
        - `createdBy` string
        - `jsonSchema` object, required
        - `name` string, required
        - `ownerApp` string
        - `tags` Tag[]
          - `key` string
          - `type` string
          - `value` string
        - `templateUI` object, required
        - `updateTime` integer
        - `updatedBy` string
        - `version` integer, required
      - `taskTriggers` HumanTaskTrigger[] — unresolved $ref
      - `userFormTemplate` UserFormTemplate
        - `name` string
        - `version` integer
    - `input` object
    - `output` object
    - `ownerApp` string
    - `state` 'PENDING' | 'ASSIGNED' | 'IN_PROGRESS' | 'COMPLETED' | 'TIMED_OUT' | 'DELETED'
    - `taskId` string
    - `taskRefName` string
    - `updatedBy` string
    - `updatedOn` integer
    - `workflowId` string
    - `workflowName` string
  - `start` integer
  - `totalHits` integer

---

[API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) · [All operations](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orkescloud/orkes-conductor-api-server/revisions/6ebf0c14ac41/schema)