---
title: "Create or update a list."
method: POST
path: "/api/lists/{list}"
tags: ["Custom Lists"]
---

# Create or update a list.

`POST /api/lists/{list}`

Create a list whose contents are the request body, or overwrite it if a list with the same name already exists. Requires the `lists:write` scope.

## Path parameters

- `list` string, required

## Query parameters

- `description` string
- `owner` string

## Headers

- `Authorization` string, required

## Request body

- string[]

## Response `200`

An existing list with the same name was updated.

## Other responses

- `201` — The list was created.
- `400` — The list name is empty, the list contains too many items (maximum 100), or an item is too long (maximum 50 characters).
- `401` — Unauthorized
- `412` — The maximum number of lists already exists.
- `413` — Content Too Large
- `415` — Unsupported Media Type
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/philterd/apis/philter-api.md) · [All operations](https://skmtc.net/philterd/apis/philter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/philterd/philter-api/versions/67443cd5a65b/schema)