---
title: "Replace the always-redact and never-redact lists."
method: POST
path: "/api/redact-lists"
tags: ["Always/Never Redact Lists"]
---

# Replace the always-redact and never-redact lists.

`POST /api/redact-lists`

Replaces both lists in full with the supplied contents - this is not a merge. Each field is the complete desired contents of that list; a list that is omitted or sent as an empty array is cleared. Terms are trimmed and blank entries are dropped. Each list may contain up to 1000 terms, and each term may be up to 100 characters. Admins may replace another user's lists by passing that user's email as owner.

## Query parameters

- `owner` string

## Headers

- `Authorization` string, required

## Request body

- string

## Response `200`

The lists were replaced.

## Other responses

- `400` — The request body is malformed, a list has too many terms, or a term is too long.
- `401`
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/philterd/apis/philter-api.md) · [All operations](https://skmtc.dev/philterd/apis/philter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/philterd/philter-api/revisions/eb0cf362b4e2/schema)