---
title: "Update a lead label"
method: PATCH
path: "/leadLabels/{id}"
tags: ["LeadLabels"]
---

# Update a lead label

`PATCH /leadLabels/{id}`

Updates one or more properties of a lead label. Only properties included in the request will be updated.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string — The name of the lead label
  - `color` 'blue' | 'brown' | 'dark-gray' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'yellow' — The color of the label. Only a subset of colors can be used.

## Response `200`

Successful response containing payload in the `data` field

- object
  - `success` boolean
  - `data` object
    - `id` string, uuid — The unique ID of the lead label
    - `name` string — The name of the lead label
    - `color` 'blue' | 'brown' | 'dark-gray' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'yellow' — The color of the label. Only a subset of colors can be used.
    - `add_time` string, date-time — The date and time of when the lead label was created. In ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
    - `update_time` string, date-time — The date and time of when the lead label was last updated. In ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

## Other responses

- `404` — A resource describing an error

---

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