---
title: "Create Pipeline"
method: POST
path: "/v1/pipeline"
---

# Create Pipeline

`POST /v1/pipeline`

Create a new pipeline configuration.

## Headers

- `authorization` string, nullable

## Request body

- CreatePipelineRequest — Request to create a new pipeline.
  - `slug` string, required — Pipeline slug (unique identifier)
  - `description` string, nullable — Pipeline description
  - `steps` PipelineStep[], required — Pipeline steps
    - `type` string, required — Step type: fetch, process, chunk, refine, export, write
    - `component` string, required — Component name (e.g., 'recursive', 'overlap')
    - `params` object — Component parameters

## Response `200`

Successful Response

- PipelineResponse — Response containing pipeline information.
  - `id` string, required
  - `slug` string, required
  - `description` string, nullable, required
  - `organization_slug` string, required
  - `steps` object[], required
  - `created_at` string, required
  - `updated_at` string, required

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