Privacy

Privacy policies catch sensitive user information before it reaches your database, public feed, or other users. They cover detection (does this content contain PII?) as well as masking (redact it from the stored content).

Policies

`id`	Type	Supported	What it does
`personal_information`	`classifier`	text, audio	Flags content that contains emails, phone numbers, addresses, or other sensitive numbers.
`intent_to_share`	`classifier`	text, audio	Flags attempts to share contact details — directly or obfuscated (e.g. “find me on Instagram”).
`pii`	`entity_matcher`	text, audio	Extracts specific PII entities (email, phone, address, etc.) and can return masked content with those entities redacted.
`face_detection`	`classifier`	image	Flags images by how many faces they contain. See Face detection.

Face detection

Face detection flags images with a single rule you write as a sentence:

Flag images that contain at least / fewer than N faces.

Both directions are useful, which is why the rule reads this way rather than as a simple on/off:

At least 1 — flag any image showing a person. Use it where faces shouldn’t appear at all, like product photos or document uploads.
Fewer than 1 — flag images with no face. Use it where a face is required, like verifying that a profile picture is actually of someone.
At least 3 — flag group photos while letting individual portraits through.

Configure it on a channel’s Policies → Privacy page. Two settings:

Setting	What it does
Flagging	The rule itself — the comparator (`at_least` or `fewer_than`) and the face count
Threshold	How confident the detector must be before a face counts

probability reports confidence that the rule is satisfied, so an absence match (“fewer than 1 face, and there are none”) reports high confidence rather than zero. Detected faces are returned on the policy’s data field.

Face detection runs on images only. It doesn’t identify anyone — it counts faces and returns no identity information.

Reading the result

const pii = response.policies.find(p => p.id === "pii");

pii?.matches?.forEach(match => {
  console.log(`${match.match} at ${match.span[0]}–${match.span[1]}`);
});

if (response.content.masked) {
  await store(response.content.modified); // PII redacted
}

See Understanding API responses for the full response shape and masking behavior.

Documentation

Learn

Resources

Policies

Face detection

Reading the result

​Policies

​Face detection

​Reading the result

Policies

Face detection

Reading the result