---
title: "Redact Companies"
method: POST
path: "/api/candidates/{candidate_id}/redact-companies"
tags: ["shortlist"]
---

# Redact Companies

`POST /api/candidates/{candidate_id}/redact-companies`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/candidates/{candidate_id}/redact-companies`
- Auth: HTTP bearer

Run (or refresh) Claude-generated company redactions for blind PDFs.

Cache-first by default. Pass `force=true` to invalidate and re-run.

## Path parameters

- `candidate_id` string, uuid, required

## Request body

- RedactCompaniesRequest: POST /api/candidates/{id}/redact-companies. Empty body = use defaults.
  - `force` boolean: Bypass cache + redaction_version match and re-run Claude. Use when the candidate's experience_entries changed but the redaction wasn't invalidated.

## Response `200`

Successful Response

- RedactCompaniesResponse
  - `candidate_id` string, uuid, required
  - `current_company_redacted` string, nullable, required
  - `past_companies_redacted` CompanyRedaction[], required
    - `original` string, required
    - `redacted` string, required
    - `role` string, nullable
    - `index` integer, required
  - `redaction_version` integer, required
  - `cached` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)