---
search:
  tags:
    - Deals
    - PATCH
seo:
  description: >-
    Early access: request API access for your workspace at
    https://bauhow.com/support… Reference for the PATCH /v1/deal-stages/{id}
    endpoint in the Bauhow API.
sidebar:
  label: Update a pipeline stage
  badge: PATCH
title: Update a pipeline stage
type: openapi-operation
---
**Early access:** request API access for your workspace at https://bauhow.com/support before using this endpoint.

Renames a stage or sets its win probability (0–100) and critical threshold in days. Pass null to clear a value. Requires the key's member to manage workspace settings.

`PATCH /v1/deal-stages/{id}`

**Request body** (`application/json`)

- `name` (string)
- `probability` (integer | null)
- `staleAfterDays` (integer | null)

Request body example:

```json
{
  "name": "string",
  "probability": 0,
  "staleAfterDays": 1
}
```

**Responses**

- `200` — OK

Response example, 200:

```json
{
  "id": "string",
  "key": "string",
  "name": "string",
  "sortOrder": -9007199254740991,
  "archived": true,
  "probability": -9007199254740991,
  "staleAfterDays": -9007199254740991
}
```
