---
title: "Create Automation Output Processor"
method: POST
path: "/automation-output-processors"
tags: ["labAutomation"]
---

# Create Automation Output Processor

`POST /automation-output-processors`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/automation-output-processors`
- Auth: HTTP bearer

Create Automation Output Processor

## Request body

- AutomationOutputProcessorCreate
  - `assayRunId` string, required
  - `automationFileConfigName` string, required
  - `completeWithErrors` boolean: Specifies whether file processing should complete with errors. False means any error in output file processing will result in no actions being committed. True means that if row-level errors occur, then failing rows and their errors will be saved to errorFile, and actions from successful rows will be committed.
  - `fileId` string, required: The ID of a blob link or the API ID of a file to process.
  - `folderId` string: The API ID of the folder to set for the automation output file. Folder items created by the correpsonding output processor will be created in this folder.
  - `locationId` string: The API ID of the location to set for the automation output file. Storable items created by the correpsonding output processor will be created at this location.
  - `timezone` string: The timezone to set for the automation output file. Used as the timezone for the timestamp fields if not set in the timestamp.

## Response `201`

Created

- AutomationOutputProcessor
  - `assayRunId` string
  - `automationFileConfig` AutomationOutputProcessorAutomationFileConfig
    - `name` string
  - `file` Blob
    - `id` string, uuid: The universally unique identifier (UUID) for the blob.
    - `mimeType` string: eg. application/jpeg
    - `name` string: Name of the blob
    - `type` 'RAW_FILE' | 'VISUALIZATION': One of RAW_FILE or VISUALIZATION. If VISUALIZATION, the blob may be displayed as an image preview.
    - `uploadStatus` 'IN_PROGRESS' | 'COMPLETE' | 'ABORTED'
  - `id` string
  - `status` 'SUCCEEDED' | 'FAILED' | 'NOT_STARTED' | 'RUNNING'
  - `apiURL` string, uri: The canonical url of the Automation Output Processor in the API.
  - `archiveRecord` ArchiveRecord
    - `reason` string
  - `completeWithErrors` boolean: Specifies whether file processing should complete with errors. False means any error in output file processing will result in no actions being committed. True means that if row-level errors occur, then failing rows and their errors will be saved to errorFile, and actions from successful rows will be committed.
  - `createdAt` string, date-time: DateTime the Automation Output Processor was created
  - `errorFile` Blob
    - `id` string, uuid: The universally unique identifier (UUID) for the blob.
    - `mimeType` string: eg. application/jpeg
    - `name` string: Name of the blob
    - `type` 'RAW_FILE' | 'VISUALIZATION': One of RAW_FILE or VISUALIZATION. If VISUALIZATION, the blob may be displayed as an image preview.
    - `uploadStatus` 'IN_PROGRESS' | 'COMPLETE' | 'ABORTED'
  - `modifiedAt` string, date-time: DateTime the Automation Output Processor was last modified
  - `progressStats` AutomationProgressStats: Processing progress information.
    - `rowsFailed` integer
    - `rowsSucceeded` integer
    - `rowsUnprocessed` integer
  - `transforms` LabAutomationTransform[]
    - `apiURL` string, uri: The canonical url of the transform in the API.
    - `blobId` string, uuid, nullable
    - `customTransformId` string, uuid, nullable
    - `errors` LabAutomationBenchlingAppErrors
      - `topLevelErrors` LabAutomationBenchlingAppErrorsTopLevelErrorsItems[]
        - `errorMessage` string
    - `id` string
    - `inputGeneratorId` string, nullable
    - `modifiedAt` string, date-time: DateTime the transform was last modified.
    - `outputProcessorId` string, nullable
    - `status` 'NOT_STARTED' | 'RUNNING' | 'FAILED' | 'SUCCEEDED'

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