---
title: "Update a List"
method: PATCH
path: "/labels/{id}"
tags: ["Miscellaneous"]
---

# Update a List

`PATCH /labels/{id}`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

A <a href="https://knowledge.apollo.io/hc/en-us/articles/4409728608525-Create-and-Use-a-List" target="_blank">list</a> is a saved group of contacts or accounts in Apollo that you can organize, action, and track together.<br><br>Use the Update a List endpoint to rename an existing list or to toggle its Book of Business status. You can't change a list's modality after it's created.<br><br>To find list IDs, call the <a href="https://docs.apollo.io/reference/get-a-list-of-all-lists">Get a List of All Lists endpoint</a> and identify the `id` value for the list you want to update.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required — The new name for the list. Must be unique for the list's modality within your team.<br><br>Example: `Conference 2024 - Maui (West)`
  - `book_of_business` boolean — Set to `true` to mark an account list as a Book of Business (BoB) list. Only applies to account lists.

## Response `200`

200

- object
  - `label` object
    - `id` string
    - `modality` string
    - `cached_count` integer
    - `name` string
    - `created_at` string
    - `updated_at` string
    - `user_id` string
    - `book_of_business` boolean, nullable

## Other responses

- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)