---
title: "Delete a list."
method: DELETE
path: "/api/lists/{name}"
tags: ["Custom Lists"]
---

# Delete a list.

`DELETE /api/lists/{name}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/lists/{name}`
- Auth: HTTP bearer

Delete a list with the given name. Requires the `lists:write` scope.

## Path parameters

- `name` string, required

## Query parameters

- `owner` string

## Headers

- `Authorization` string, required

## Response `204`

The list was deleted.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Insufficient scope, disabled API, or access denied.
- `404`: The given list does not exist.
- `406`: No representation matches Accept.
- `413`: Content Too Large
- `415`: Unsupported Media Type
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-17** `fddc8a37e181`: 1 breaking
  - removed the media type `application/json` for the response with the status `204`
- **2026-10-10** `c4f85daa9208`: 1 breaking, 15 info
  - the response's body type changed from `string` to `object` for status `404`
  - added the optional property `field` to the response with the `400` status
  - added the optional property `field` to the response with the `401` status
  - added the optional property `field` to the response with the `404` status
  - …12 more
- **2026-10-05** `4082c17721d8`: 6 breaking, 6 info
  - removed the media type `*/*` for the response with the status `400`
  - removed the media type `*/*` for the response with the status `401`
  - removed the media type `*/*` for the response with the status `413`
  - removed the media type `*/*` for the response with the status `415`
  - …8 more
- **2026-09-07** `a3bc5909807a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/philterd/apis/philter-api/changes/api/lists/:name/delete.md)

---

[API](https://skmtc.dev/philterd/apis/philter-api.md) - [All operations](https://skmtc.dev/philterd/apis/philter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/philterd/apis/philter-api/revisions/aa3d7ad1aab4?raw)