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

# Append to the always-redact and never-redact lists.

`PUT /api/redact-lists`

Appends the supplied terms to the existing lists rather than replacing them - use POST to replace. Each field's terms are added to the current contents of that list; a list that is omitted or sent as an empty array is left unchanged. Terms are trimmed, blank entries are dropped, and terms already present are not added again. The resulting list may contain up to 1000 terms, and each term may be up to 100 characters; an append that would exceed the limit is rejected. Admins may append to 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 terms were appended.

## Other responses

- `400` — The request body is malformed, the resulting 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)