---
title: "update a Pipeline within an Application."
method: PATCH
path: "/orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}"
tags: ["public", "Pipelines"]
---

# update a Pipeline within an Application.

`PATCH /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}`

## Path parameters

- `orgId` string, required
- `appId` string, required
- `pipelineId` string, required

## Query parameters

- `dry_run` boolean

## Headers

- `If-Match` string

## Response `200`

Successful get response.

- Pipeline — An object containing the details of a Pipeline.
  - `id` string, required — The id of the Pipeline.
  - `etag` string, required — The current entity tag value for this Pipeline.
  - `org_id` string, required — The id of the Organization containing this Pipeline.
  - `app_id` string, required — The id of the Application containing this Pipeline.
  - `name` string, required — The name of the Pipeline.
  - `status` string, required — The current status of the Pipeline.
  - `version` string, required — The unique id of the current Pipeline Version.
  - `created_at` string, date-time, required — The date and time when the Pipeline was created.
  - `trigger_types` string[], required — The list of trigger types in the current schema.
  - `metadata` object — The map of key value pipeline additional information

## Other responses

- `204` — The request was valid, but no Pipeline was updated.
- `400` — The request was invalid. More detail can be found in the error body.
- `404` — Either the resource or a related resource could not be found. More detail can be found in the error body.
- `409` — The request itself is valid however it could not be applied based on the current state of the resource. More detail can be found in the error body.
- `412` — The request itself is valid however it could not be applied because the Etag does not match.

---

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