Privacy

Erase a person and suppress them

Changed on

Deletes every row in this workspace that names the person and, unless suppress is false, adds a hashed suppression so they never come back in search or contact lookup.

Scope: privacy:write.

post/v1/erasures

Request

  • Base URL: https://api.recruitmcp.com
  • URL: https://api.recruitmcp.com/v1/erasures
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: privacy:write)

Headers

Idempotency-Keystring

Optional on this route. At most 128 characters. When present, the same key and body replays the first response for 24 hours. A different body is 409 idempotency_key_reused. A second call waits for the first and replays it. Omit the header to run the request normally.

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Request body

profile_idstring
profile_urlstring
suppressboolean

Default true.

Response

What was erased.

subjectstring required

Hash of the subject, for your records.

erasedobject required
suppressedboolean required

Example response

{
  "cost": {
    "credits": 0,
    "cached_items": 0,
    "live_items": 0,
    "upstream_calls": 0
  }
}

Changes

  • ad27b35513a6Revision changes
    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status