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

## 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` — 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)