Privacy

Delete cached profiles, pages, and contact details

Changed on Oct 20, 2026

Deletes every cached profile, cached search page, and stored contact detail in this workspace. It cannot be undone, and the next search, fetch, or contact lookup pays again. ?dry_run=true returns what would be deleted and deletes nothing. Executing needs ?confirm_delete=true; without it the call is 400 confirmation_required and nothing is deleted.

Scope: privacy:write.

delete/v1/privacy/cache

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/privacy/cache
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)

Query parameters

dry_runboolean

Preview only. Nothing is deleted.

confirm_deleteboolean

Required to delete. Without it nothing is deleted.

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.

Response

Dry run: what would be deleted.

objectstring required

cache_deletion

dry_runboolean required

deletedboolean required

Always false on a dry run.

would_deletestring[] required

effectstring

executestring

The call that deletes.

Example response

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

Changes

Oct 20, 2026ad27b35513a6 Revision 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

Operation history