---
title: "Assign or unassign a list for one unlocked leak"
method: PUT
path: "/profile/unlocked/{leak_id}/list"
tags: ["Unlocked Leaks Lists"]
---

# Assign or unassign a list for one unlocked leak

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

## Request

- Base URL: `https://api.leakradar.io`
- URL: `https://api.leakradar.io/profile/unlocked/{leak_id}/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/leakradar/apis/leakradar-io-api/docs/profile/unlocked/:leak_id/list/put.ts> (a function with typed inputs; its response is checked against the schema)

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

Behavior
- Provide `list_id` to assign. Use `null` to remove the assignment.

**Errors**
- 401 Authentication required, or invalid/expired API key.
- 404 Unlocked leak not found, or list not found.
- 422 Request validation error.
- 429 Rate limit exceeded.

## Path parameters

- `leak_id` string, required: Unlocked leak identifier

## Request body

- AssignListIn
  - `list_id` integer, nullable: null to remove list

## Response `200`

List assignment updated.

- unknown

## Other responses

- `401`: Authentication required, or invalid/expired API key.
- `404`: Unlocked leak not found, or list not found.
- `422`: Validation error.
- `429`: Rate limit exceeded.

## Changes

- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/unlocked/: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/8dcd4b54cc4a?raw)