---
title: "Update Pipeline"
method: PUT
path: "/api/v1/pipelines/{pipeline_id}"
tags: ["pipelines"]
---

# Update Pipeline

`PUT /api/v1/pipelines/{pipeline_id}`

Update pipeline steps. This is the auto-save path.

## Path parameters

- `pipeline_id` string, required

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Request body

- UpdatePipelineRequest
  - `steps` PipelineStep[], nullable — Ordered list of pipeline steps
    - `type` 'convert' | 'extract' | 'segment' | 'custom' | 'fill', required — The type of processing step
    - `settings` object — Step-specific executor settings. For extract steps, includes 'page_schema' (JSON string, same format as the /extract endpoint's page_schema). For segment steps, includes 'segmentation_schema' (JSON string, same format as the /segment endpoint's segmentation_schema). These flow directly to the executor via config.update(settings).
    - `custom_processor_id` string, nullable — Custom processor ID (cp_XXXXX) for custom steps
    - `eval_rubric_id` integer, nullable — Eval rubric ID to score this step's output against
    - `pending_check_url` string, nullable — URL to poll for processor creation status (temporary, cleared on completion)
    - `pending_name` string, nullable — Display name while processor is generating (temporary, cleared on completion)

## Response `200`

Successful Response

- PipelineResponse
  - `id` integer, required
  - `pipeline_id` string, required
  - `name` string, nullable, required
  - `steps` unknown[], required
    - unknown
  - `is_saved` boolean, required
  - `archived` boolean, required
  - `active_version` integer, required
  - `created` string, date-time, nullable, required
  - `updated` string, date-time, nullable, required
  - `reused` boolean

## Other responses

- `422` — Validation Error

---

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