---
title: "Approve a document's pending classification"
method: POST
path: "/v1/knowledge-base/documents/{doc_id}/classification/approve"
tags: ["knowledge-base"]
---

# Approve a document's pending classification

`POST /v1/knowledge-base/documents/{doc_id}/classification/approve`

## Path parameters

- `doc_id` string, uuid, required

## Request body

- ClassificationApprove — Request body for POST /documents/{doc_id}/classification/approve (ENG-647). Approving with no ``sensitivity`` confirms the document's current effective label and clears the review flag (``pending_review``/``pending_unsearchable`` → ``active``). Supplying ``sensitivity`` re-labels the document on approval, subject to the same anti-escalation as the PATCH endpoint (a LOWER needs ``org:manage``). ``reason`` is recorded on the classification audit event.
  - `sensitivity` 'public' | 'internal' | 'confidential' | 'restricted', 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)