---
title: "Manually correct a document's sensitivity classification"
method: PATCH
path: "/v1/knowledge-base/documents/{doc_id}/classification"
tags: ["knowledge-base"]
---

# Manually correct a document's sensitivity classification

`PATCH /v1/knowledge-base/documents/{doc_id}/classification`

## Path parameters

- `doc_id` string, uuid, required

## Request body

- ClassificationPatch — Request body for PATCH /documents/{doc_id}/classification. Optionally sets the document's effective ``sensitivity`` (a RAISE is sticky; a LOWER is content-scoped and additionally requires ``org:manage`` — anti-escalation is enforced in the service layer) and/or its audience scope (ENG-648): ``visibility_mode='audience'`` + ``audience_tags`` narrows the doc to those groups; ``visibility_mode='org_wide'`` re-opens it. At least one field must be supplied. ``reason`` is recorded on the audit event(s).
  - `sensitivity` 'public' | 'internal' | 'confidential' | 'restricted', nullable
  - `visibility_mode` 'org_wide' | 'audience', nullable
  - `audience_tags` string[], nullable
  - `reason` string, nullable

## Response `200`

Successful Response

- ClassificationResponse — Current classification of a document. Built explicitly (not ``from_attributes``) because ``document_id`` maps to ``Document.id`` and ``detected_sensitivity`` comes from the active version.
  - `document_id` string, uuid, required
  - `sensitivity` string, required
  - `sensitivity_level` integer, required
  - `classification_source` string, nullable, required
  - `classification_status` string, required
  - `classification_confidence` number, nullable, required
  - `classified_at` string, date-time, nullable, required
  - `classified_by` string, nullable, required
  - `manual_override_floor` integer, nullable, required
  - `manual_lower_hash` string, nullable, required
  - `visibility_mode` string, required
  - `audience_tags` string[], required
  - `detected_sensitivity` string, nullable

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `404` — Resource not found
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)