---
title: "Execute Pipeline"
method: POST
path: "/v1/pipeline/{pipeline_slug}"
---

# Execute Pipeline

`POST /v1/pipeline/{pipeline_slug}`

Execute a pipeline with provided input.

## Path parameters

- `pipeline_slug` string, required

## Headers

- `authorization` string, nullable

## Request body

- ExecutePipelineRequest — Request to execute a pipeline.
  - `text` union — Text to process
    - string
    - string[]
  - `file` object, nullable — File reference with OCR
  - `ocr` string — OCR provider (mistral or gemini)

## Response `200`

Successful Response

- PipelineExecutionResponse — Response from pipeline execution.
  - `chunks` object[], required — Resulting chunks from pipeline
  - `metadata` object, nullable — Additional execution metadata

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chonkie/apis/chonkie-api.md) · [All operations](https://skmtc.dev/chonkie/apis/chonkie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chonkie/apis/chonkie-api/revisions/f40f036f941c?raw)