Redact PII

Replaces detected PII with placeholders and returns the reverse mapping needed to restore the original text.

post/v2/pii/redact

Request body

textstring
languagestring
thresholdnumber double
regionsstring[]

Region codes selecting whole regions of coverage, e.g. "nl", "gb". Every entity type those regions cover is included, alongside the base catalog. ["all"] is exclusive. Leaving this and entities both empty also runs every region, so selecting nothing is the widest request rather than the narrowest. Empty alongside a non-empty entities stays strict. See the capabilities endpoint for the region list.

Combines with entities: the detector unions the two selections, so a request carrying both covers the regions plus the named types. Note that entities only narrows coverage when it travels alone.

entitiesstring[]

The entity types to cover. A named type fires even when it belongs to a region, so a region's types can be selected individually without naming the region. Alone this is a strict allowlist; alongside regions it adds to the region coverage instead of narrowing it.

entity_thresholdsobject

Per-entity confidence cutoff overrides. An override REPLACES the global threshold for that type and may sit above or below it: the gateway lowers the first-pass floor it sends the detector to the smallest value in the map, and every selected type carries its own cutoff, so a sub-global override detects MORE of that type without widening the rest.

This only tunes confidence; it never changes which types are covered. Coverage is decided by entities alone, so every key here must also appear in entities — a key that does not is rejected, as is any key at all when entities is empty.

Declarative [0,1] bound mirrors existing constraint on threshold.

Response

OK

redacted_textstring
mappingsobject

Maps each placeholder (e.g. "<PERSON_1>") to the original value it replaced.

Changes

Changed in 5 of the 350 revisions of this API.69

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    This revision also has 92 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    This revision also has 70 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 350 revisions, 136 have no diff computed.