---
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. Requires the `lists:write` scope.

## 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` — The Authorization header is absent or the API key is not recognized.
- `404` — The owner does not exist, or the caller is not an admin.
- `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)