Get a source's diff review state
Read a synchronized source’s diff policy and its runs’ review phases.
v2 compatibility notes
GET /api/v2/knowledge/synchronized-sources/diff?sourceId= requires knowledge:read. It answers the source’s diff policy (policy, null when its changes apply without review) and the policy’s revision (policyRevision, which setDiffPolicy takes), the kinds the source declares, canManage (whether this key may decide: it and its owner hold knowledge:manage where the source lives), each recent run’s diff phase, revision and expiresAt, and shrinkGuards: each recent run’s shrink guard, with or without a diff, as its runId, phase, the revision that approveShrink and overrideShrink take, thresholdPercent and the held deletions’ totals (pending, deleted, superseded). A guard’s decider and cursors are never returned. A missing, unreadable or being-removed source answers 404 resource_missing.
A run in phase held waits for review: review its diff, then approve or reject it.
Only a Personal key is admitted, acting as its owner: the owner must hold the permission where the source lives, and is recorded as the reader, with the key named in the audit. An External App or platform key answers 403 forbidden, recorded: a person reviews and decides a source’s held changes.Authorizations
Path Parameters
Response
Diff review state
A synchronized source's diff review state: its diff policy (null when its changes apply without review) and the policy's revision, which setDiffPolicy takes as expectedRevision; the kinds the source declares; whether the caller may decide (its key holds knowledge:manage where the source lives, and so does its owner); each recent run's diff phase, revision and expiry; and shrinkGuards, each recent run's shrink guard (with or without a diff): its phase, the revision that approveShrink and overrideShrink take, its threshold and the held deletions' totals. A guard in phase review waits for a person's decision. A guard's decider and cursors are never returned.

