---
title: "Clear list assignment from leaks while keeping the list"
method: POST
path: "/profile/unlocked/lists/{list_id}/clear"
tags: ["Unlocked Leaks Lists"]
---

# Clear list assignment from leaks while keeping the list

`POST /profile/unlocked/lists/{list_id}/clear`

## Request

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

Remove the list assignment from all unlocked leaks that currently reference this list. The list itself is kept. The operation runs in the background. `task_id` is the backward-compatible primary task and `task_ids` contains every dataset cleanup task.

## Path parameters

- `list_id` integer, required: ID of the list whose assignments will be cleared

## Response `200`

Clear task started.

- ListCleanupTasksOut: Backward-compatible primary task plus every dataset cleanup task.
  - `task_id` string, required
  - `running` boolean, required
  - `completed` boolean, required
  - `total` integer, nullable
  - `updated` integer, nullable
  - `version_conflicts` integer, nullable
  - `task_ids` string[], required

## Other responses

- `401`: Authentication required, or invalid/expired API key.
- `404`: List not found.
- `422`: Validation Error

## Changes

- **2026-09-04** `eb219e94d077`: 1 info
  - added the required property `task_ids` to the response with the `200` status
- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/unlocked/lists/:list_id/clear/post.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)