---
title: "Update a lead stage"
method: PATCH
path: "/lead-stages/{id}"
tags: ["Reference Data"]
---

# Update a lead stage

`PATCH /lead-stages/{id}`

Updates a lead stage's label or type. Only provided fields are changed.

## Path parameters

- `id` string, required

## Request body

- LeadStageUpdateInput
  - `label` string — Lead stage label
  - `type` 'NEW' | 'CONTACTED' | 'UNQUALIFIED' | 'CONVERTED' | 'JUNK' — Lead stage type

## Response `200`

OK

- LeadStage
  - `id` string, required — Lead stage ID
  - `label` string, required — Lead stage label
  - `type` string, required — Lead stage type
  - `position` number, required — Lead stage position

## Other responses

- `400` — Validation error or bad request
- `401` — Missing or invalid API key
- `403` — Insufficient permission
- `404` — Resource not found
- `429` — Rate limit exceeded

---

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