---
title: "Create a new workflow output"
method: POST
path: "/workflow-outputs"
tags: ["workflowOutputs"]
---

# Create a new workflow output

`POST /workflow-outputs`

## Request

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

Create a new workflow output

## Request body

- WorkflowOutputCreate
  - `fields` Fields
  - `workflowTaskId` string, required: The ID of the workflow task this output belogns to

## Response `201`

OK

- WorkflowOutput
  - `displayId` string: User-friendly ID of the workflow task group
  - `id` string: The ID of the workflow output
  - `archiveRecord` ArchiveRecord
    - `reason` string
  - `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
  - `fields` Fields
  - `modifiedAt` string: The ISO formatted date and time that the task was last modified
  - `nextOutputs` WorkflowOutputSummary[]: The outputs in the flowchart which are generated by this output.
    - `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 output.
    - `displayId` string: User-friendly ID of the workflow task
    - `id` string: The ID of the workflow task
  - `sourceOutputs` WorkflowOutputSummary[]: The outputs in the flowchart which were used to generate this output.
    - `displayId` string: User-friendly ID of the workflow task group
    - `id` string: The ID of the workflow output
  - `sourceTasks` WorkflowTaskSummary[]: The tasks in the flowchart which were used to generate this output.
    - `displayId` string: User-friendly ID of the workflow task
    - `id` string: The ID of the workflow task
  - `webURL` string, uri: URL of the workflow output
  - `workflowTask` WorkflowTaskSummary
    - `displayId` string: User-friendly ID of the workflow task
    - `id` string: The ID 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

## 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)