POST /v1/redact.
Using a redaction template in /v1/redact needs a paid plan. On the Free plan, a request with template returns 403.
Creating a template
In the Dashboard, open Redaction in the sidebar and create a template:- Name — e.g. “HIPAA Patient Record”. The slug comes from the name, e.g.
hipaa-patient-record. - Description — optional notes.
- Presets — built-in patterns to include:
ssn,email,phone,date-of-birth,credit-card. See Presets. - Custom patterns — up to 50 literal strings or regular expressions, each with an optional page and color.
Applying a template
With inline patterns
Addpatterns, presets, and redactions to the same request. Everything is applied together:
patterns.
In the Document Editor
In the Dashboard’s Document Editor, open the Redact panel in Search mode and use Load template to apply a saved template to the open document.Managing templates
A redaction template belongs to the account (personal or organization) that created it. On the Redaction page you can list, edit, and delete templates. API keys can read them withGET /v1/redaction-templates.
Redaction templates are a hosted API feature. On the self-hosted server, pass
patterns and presets in each request.Related
- Redaction — how Forme redaction works
- Redact PDF — the hosted endpoint