---
title: "Update an Unlocked List"
method: PATCH
path: "/profile/unlocked/lists/{list_id}"
tags: ["Unlocked Leaks Lists"]
---

# Update an Unlocked List

`PATCH /profile/unlocked/lists/{list_id}`

Update list metadata. Only provided fields are updated.

Updatable fields
- `name` must be unique per account, case-insensitive.
- `color` optional UI attribute.

**Errors**
- 401 Authentication required, or invalid/expired API key.
- 404 List not found.
- 409 A list with the same name already exists.
- 422 Request validation error.

## Path parameters

- `list_id` integer, required — ID of the list to update

## Request body

- UnlockedListUpdateIn
  - `name` string, nullable
  - `color` string, nullable

## Response `200`

List updated successfully.

- UnlockedListOut
  - `id` integer, required
  - `name` string, required
  - `color` string, nullable, required
  - `created_at` string, nullable, required
  - `updated_at` string, nullable, required
  - `items_count` integer, nullable

## Other responses

- `401` — Authentication required, or invalid/expired API key.
- `404` — List not found.
- `409` — A list with the same name already exists.
- `422` — Validation error.

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leakradar/apis/leakradar-io-api/revisions/99aaaa4fbeb1?raw)
