---
title: "Assign or unassign a list for one unlocked combolist credential"
method: PUT
path: "/profile/unlocked/combolists/{leak_id}/list"
tags: ["Unlocked Combolists"]
---

# Assign or unassign a list for one unlocked combolist credential

`PUT /profile/unlocked/combolists/{leak_id}/list`

Assign a specific unlocked list to a single unlocked combolist credential, or unassign it.

Behavior
- Provide `list_id` to assign. Use `null` to remove the assignment.
- Lists are shared with unlocked leaks: the same list can hold records from both datasets. Counts per dataset are read from `GET /profile/unlocked/lists?dataset=combolist`.

## Path parameters

- `leak_id` string, required — Combolist credential ID, in the `cl1_` namespace.

## Request body

- CombolistListUpdate
  - `list_id` integer, nullable

## Response `200`

List assignment updated.

- object

## Other responses

- `401` — Authentication required, or invalid/expired API key.
- `404` — Unlocked combolist credential not found, or combolist search is not enabled on this deployment.
- `422` — Validation error.
- `429` — Rate limit exceeded. See Retry-After / X-RateLimit-* headers.

## Changes

- **2026-09-04** `eb219e94d077` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/unlocked/combolists/:leak_id/list/put.md)

---

[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)
