---
title: "Update a pipeline"
method: POST
path: "/v4/pipelines/{id}"
tags: ["Pipelines"]
---

# Update a pipeline

`POST /v4/pipelines/{id}`

Update the details of a pipeline by ID

## Path parameters

- `id` string, uuid, required — Pipeline UUID

## Request body

- UpdatePipeline
  - `displayName` string, nullable — Pipeline display name
  - `folderId` string, uuid, nullable — Folder UUID
  - `isArchived` boolean — Whether the pipeline is archived

## Response `200`

Successful response

- Pipeline
  - `id` string, uuid, required — Pipeline UUID
  - `createdAt` string, required — Creation timestamp (ISO 8601)
  - `updatedAt` string, required — Last update timestamp (ISO 8601)
  - `slug` string, required — Pipeline slug
  - `displayName` string, nullable, required — Pipeline display name
  - `folderId` string, uuid, nullable, required — Folder UUID
  - `archivedAt` string, nullable, required — Archive timestamp (ISO 8601)
  - `goldenDatasetId` string, uuid, nullable, required — Golden dataset UUID

## Other responses

- `400` — Client provided an invalid request for the pipeline. Please check the request format and parameters.
- `401` — No valid API key provided.
- `404` — The pipeline resource does not exist.
- `500` — Something went wrong on Gentrace's end.

---

[API](https://skmtc.net/gentrace/apis/gentrace-api.md) · [All operations](https://skmtc.net/gentrace/apis/gentrace-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gentrace/gentrace-api/versions/938ac0c5af7b/schema)