---
title: "Update a pipeline"
method: PATCH
path: "/v1/pipelines/{id}"
tags: ["v1Pipelines"]
---

# Update a pipeline

`PATCH /v1/pipelines/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdatePipelinePublicDto
  - `name` string — Nome do funil
  - `position` number — Posição do funil
  - `stages` PipelineStage[] — Estágios do funil
    - `id` string, required
    - `name` string, required
    - `color` string, required
    - `requireds` string[], required
  - `rules` PipelineRule[] — Regras do funil
    - `ruleId` string, required
    - `max` number, required
    - `stageId` string
  - `kind` 'commercial' | 'operational' — Tipo do funil
  - `cadence` Cadence[] — Cadência associada ao funil
    - `stageId` string, required
    - `task` object
    - `id` string
  - `lostReasons` string[]
  - `requiredCustomFieldIds` string[]
  - `privacy` Privacy
    - `type` 'private' | 'public' | 'team' | 'user', required
    - `groupIds` string[], required
    - `userId` string
  - `authorId` number

## Response `200`

- PipelinePublicDto
  - `id` string, required
  - `name` string, required — Nome do funil
  - `position` number, required — Posição do funil
  - `stages` PipelineStage[], required — Estágios do funil
    - `id` string, required
    - `name` string, required
    - `color` string, required
    - `requireds` string[], required
  - `rules` PipelineRule[], required — Regras do funil
    - `ruleId` string, required
    - `max` number, required
    - `stageId` string
  - `kind` 'commercial' | 'operational' — Tipo do funil
  - `cadence` Cadence[] — Cadência associada ao funil
    - `stageId` string, required
    - `task` object
    - `id` string
  - `lostReasons` string[]
  - `requiredCustomFieldIds` string[]
  - `privacy` Privacy
    - `type` 'private' | 'public' | 'team' | 'user', required
    - `groupIds` string[], required
    - `userId` string
  - `authorId` number

---

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