---
title: "List workflow tasks"
method: GET
path: "/workflow-tasks"
tags: ["workflowTasks"]
---

# List workflow tasks

`GET /workflow-tasks`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/workflow-tasks`
- Auth: HTTP bearer

List workflow tasks

## Query parameters

- `ids` string
- `workflowTaskGroupIds` string
- `schemaId` string
- `statusIds` string
- `assigneeIds` string
- `watcherIds` string
- `responsibleTeamIds` string
- `executionOriginIds` string
- `executionTypes` string
- `linkedItemIds.anyOf` string
- `linkedItemIds.allOf` string
- `linkedItemIds.noneOf` string
- `schemaFields` SchemaFieldsQueryParam
- `name` string
- `nameIncludes` string
- `creatorIds` string
- `scheduledOn` union
  - 'null'
  - string, date
- `scheduledOn.lt` string, date
- `scheduledOn.lte` string, date
- `scheduledOn.gte` string, date
- `scheduledOn.gt` string, date
- `modifiedAt` string
- `nextToken` string
- `pageSize` integer
- `displayIds` string
- `archiveReason` string

## Response `200`

OK

- WorkflowTasksPaginatedList
  - `nextToken` string
  - `workflowTasks` WorkflowTask[]
    - `displayId` string: User-friendly ID of the workflow task
    - `id` string: The ID of the workflow task
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `assignee` UserSummary
      - `handle` string
      - `id` string
      - `name` string
    - `clonedFrom` WorkflowTaskSummary
      - `displayId` string: User-friendly ID of the workflow task
      - `id` string: The ID of the workflow task
    - `createdAt` string: The ISO formatted date and time that the task was created
    - `creationOrigin` CreationOrigin
      - `application` string, nullable
      - `originId` string, nullable
      - `originModalUuid` string, uuid, nullable
      - `originType` string, nullable
    - `creator` UserSummary
      - `handle` string
      - `id` string
      - `name` string
    - `executionOrigin` WorkflowTaskExecutionOrigin: The context into which a task was executed
      - `entryId` string, nullable
      - `originModalUuid` string, uuid, nullable
      - `type` 'API' | 'ENTRY' | 'MODAL'
    - `fields` Fields
    - `modifiedAt` string: The ISO formatted date and time that the task was last modified
    - `outputs` WorkflowOutputSummary[]
      - `displayId` string: User-friendly ID of the workflow task group
      - `id` string: The ID of the workflow output
    - `scheduledOn` string, date, nullable: The date on which the task is scheduled to be executed
    - `schema` WorkflowTaskSchemaSummary
      - `id` string: The ID of the workflow task schema
      - `name` string: The name of the workflow task schema
    - `status` WorkflowTaskStatus
      - `displayName` string: The status label
      - `id` string: The ID of the workflow task status
      - `statusType` 'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'CANCELLED' | 'INVALID' | 'COMPLETED': The status type
    - `webURL` string, uri: URL of the workflow task
    - `workflowTaskGroup` WorkflowTaskGroupSummary
      - `displayId` string: User-friendly ID of the workflow task group
      - `id` string: The ID of the workflow task group
      - `name` string: The name of the workflow task group
    - `executionFlowchartId` string: The ID of the flowchart that this task will execute. This will only be defined if the task has exectutionType FLOWCHART
    - `executionType` 'DIRECT' | 'ENTRY' | 'FLOWCHART' | 'PROCEDURE' | 'PROCEDURE_METHOD' | 'PROCEDURE_STEP': The method by which the task of the workflow is executed
    - `nextOutputs` WorkflowOutputSummary[]: The outputs in the flowchart which are generated by this task.
      - `displayId` string: User-friendly ID of the workflow task group
      - `id` string: The ID of the workflow output
    - `nextTasks` WorkflowTaskSummary[]: The downstream tasks in the flowchart which are generated by this task.
      - `displayId` string: User-friendly ID of the workflow task
      - `id` string: The ID of the workflow task
    - `responsibleParties` PartySummary[]: List of users and teams that are responsible for this task
      - `handle` string
      - `id` string
      - `name` string
    - `rootTask` WorkflowTaskSummary
      - `displayId` string: User-friendly ID of the workflow task
      - `id` string: The ID of the workflow task
    - `sourceOutputs` WorkflowOutputSummary[]: The parent outputs in the flowchart which were used to generate this task.
      - `displayId` string: User-friendly ID of the workflow task group
      - `id` string: The ID of the workflow output
    - `sourceTasks` WorkflowTaskSummary[]: The parent tasks in the flowchart which were used to generate this task.
      - `displayId` string: User-friendly ID of the workflow task
      - `id` string: The ID of the workflow task
    - `workflowOutputs` WorkflowOutputSummary[]: The outputs of the workflow task group
      - `displayId` string: User-friendly ID of the workflow task group
      - `id` string: The ID of the workflow output

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)