---
title: "Pipeline Async"
method: POST
path: "/pipeline_async"
---

# Pipeline Async

`POST /pipeline_async`

## Request body

- V3AsyncPipelineConfig
  - `async` ConfigV3AsyncConfig
    - `metadata` unknown
    - `priority` boolean — If True, attempts to process the job with priority if the user has priority processing budget available; by default, sync jobs are prioritized above async jobs.
    - `webhook` union — The webhook configuration for the asynchronous processing.
      - SvixWebhookConfig
        - `mode` 'svix'
        - `channels` string[] — A list of Svix channels the message will be delivered down, omit to send to all channels.
      - DirectWebhookConfig
        - `mode` 'direct'
        - `url` string, required
  - `input` union, required — For parse/split/extract pipelines, the URL of the document to be processed. You can provide one of the following: 1. A publicly available URL 2. A presigned S3 URL 3. A reducto:// prefixed URL obtained from the /upload endpoint after directly uploading a document 4. A jobid:// prefixed URL obtained from a previous /parse invocation 5. A list of URLs (for multi-document pipelines, V3 API only) For edit pipelines, this should be a string containing the edit instructions
    - string
    - string[]
    - UploadResponse
      - `file_id` string, required
      - `presigned_url` string, nullable
  - `pipeline_id` string, required — The ID of the pipeline to use for the document.
  - `settings` PipelineSettings — Settings for pipeline execution that override pipeline defaults.
    - `document_password` string, nullable — Password to decrypt password-protected documents.

## Response `200`

Successful Response

- AsyncPipelineResponse
  - `job_id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reductoai/apis/reducto-api.md) · [All operations](https://skmtc.dev/reductoai/apis/reducto-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reductoai/reducto-api/revisions/909015e871ed/schema)