> For the complete documentation index, see [llms.txt](https://k-ai.gitbook.io/knowledge-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://k-ai.gitbook.io/knowledge-ai/k-ai-audit/changelog.md).

# Changelog

## 1.5.0 — 2026-11-04

* K-AI Audit can be added to an instance that is already deployed — platform operation `platform_instance_enable_clean` (`POST /studio/instance/enable-clean`), or **Add Clean…** in the instance's settings in the app. Irreversible. Search keeps working; the first audit pass starts once indexing has finished.
* `audit_dashboard_get` and `audit_instance_get`: `pipeline_state.milestones` — `first_audit_started_at`, `first_audit_completed_at`, `audit_added_at`, each present once reached.
* `AUTHORITY_MANAGER` views and configures every audit instance of its organization (settings, team, `audit_mandatory_question_force_analyze`), and resolves items only on the instances whose Clean team it belongs to. Other callers see `403` on resolution operations, as before.
* `audit_mandatory_question_list` is a read: any caller who can view the instance can call it. Closing or deleting an assertion case requires the right to resolve.

## 1.4.0 — 2026-10-22

* `audit_question_conflict_get`, `audit_full_audit_conflict_get` and the unified conflict detail: each document carries `location` (section path, position, table row, image flag, closest passage, search string and occurrence) and `location_status` (`found`, `not_found`, `pending`, `unavailable`). Computed automatically from the document's indexed text for every live conflict; no page numbers. New schema `DocumentLocation`.
* Conflict detail in the app: a **Where to find it** column next to **What the document says** for each document.

## 1.3.1 — 2026-10-22

* `audit_question_conflict_list` accepts `IGNORED` in `state_in`.
* `audit_full_audit_conflict_list`: `only_linked_to_question` is applied before pagination, so pages are full until the priority subset is exhausted; `503` (`conflict_list_unavailable`) when it cannot be read completely.
* `audit_mandatory_question_force_analyze`: `404` for an unknown question, as for a question of another instance.
* `audit_missing_subject_generate_compagnon_document`: `404` when the subject does not exist or is not on the instance.
* `audit_documents_get_recommendations`: a recommendation coming from a full-audit conflict carries an `fc_*` id.

## 1.3.0 — 2026-10-21

API reference resynchronised with the production service: 69 REST endpoints, 22 MCP tools.

* New MCP tool `audit_documents_get_scoring` (`POST /audit/document/scoring`) — a document's governance score per criterion, with the actions that would raise it.
* New pages: [Unified conflicts](/knowledge-ai/k-ai-audit/api-reference/unified-conflicts.md) (one surface over `qc_*` and `fc_*`, with pins and notes), [Assertion cases](/knowledge-ai/k-ai-audit/api-reference/assertion-cases.md).
* Documents: owner assignment (`owner-context`, `claim-owner`, `assign-owner`), `scoring-averages`, `summary-by-ref-ids`, `conflicts-for-document`.
* Mandatory questions: soft delete with `delete-impact`, `delete`, `restore`. Missing subjects: pins and notes.
* Instances & users: `list-org-users`, `attach-existing-user`, `instances-for-user`.
* Removed from the reference (no longer served): the three `/audit/stats/*` endpoints, `document/count`, `document/list-with-state`, `document/set-owner`, `conflict/get-top-collaborators`, `full-audit/have-to-show`, `mandatory-question/set-managed`, `mandatory-question/set-ignored`, `instance/list-instances-for-user`, `instance/get-kai-instances`, `instance/update-instance-step`, and five `/audit/user/*` membership endpoints.

## 1.2.0 — 2026-08-26

* The Audit API and Audit MCP endpoint accept an [Organization API key](/knowledge-ai/authentication/organization-api-keys.md) directly in `Authorization: Bearer` — no OAuth, no exchange step. See [Autonomous agents (API key)](/knowledge-ai/k-ai-mcp/autonomous-agents.md).
* Key authentication returns `401` (refused — stop) or `503` with `Retry-After` (retry). No other code comes out of that path.
* Endpoint and tool counts unchanged: 48 REST endpoints, 21 MCP tools.

## 1.1.0 — 2026-06-23

* Added `audit_question_conflict_ignore` (`POST /audit/conflict/set-ignored`) — mark a question conflict as `IGNORED` for false positives that need no change. Mirrors `audit_full_audit_conflict_ignore`.
* Question conflicts now carry the `IGNORED` state (full set: `OPEN`, `ANSWERED`, `RECOMMENDATIONS_READY`, `MANAGED`, `IGNORED`).
* `audit_full_audit_conflict_list` accepts `only_linked_to_question`; full-audit conflicts now expose `linked_questions` and `is_important` to surface the priority subset linked to mandatory questions.
* 48 REST endpoints; 21 MCP tools.

## 1.0.0 — 2026-05-13

* Initial GitBook documentation under the DKP positioning.
* 47 REST endpoints documented across 8 domains.
* 20 MCP tools — curated conflict-first surface over the REST API.

## 0.x — pre-DKP refonte

Earlier history captured in the internal monorepo git logs.