Get a knowledge source's kinds
Read one synchronized knowledge source’s kinds — each kind’s completeness with every failing condition, its verification, quarantined items and record count. Requires knowledge:read.
v2 compatibility notes
GET /api/v2/knowledge/synchronized-sources/getKindStates?sourceId= reads one synchronized source the caller can read, as the Console source drawer’s Completeness section shows it. MCP hosts call it through forge_call_operation with operationId getSynchronizedSourceKindStates. It needs knowledge:read.
The response is { data: { sourceId, sealed, maximumVerificationAgeHours, kinds }, meta }. Each kind carries:
kindand itsdisplayName;status:complete,incompleteorstale, with thereasonwhen it is not complete;failingConditions: every completeness condition it fails now;verifiedAt,verification(okorfailed) andfailedChecks;quarantinedCountandrecordCount.
complete explains why List knowledge records refuses its records. A source whose first pass has not completed has no kinds yet: follow its progress with List source runs.
At most 100 kinds are read; meta.partial is true when the source holds that many. A source that is missing, being removed, or outside the caller’s readable namespaces answers the same 404 resource_missing, so a caller cannot probe for sources it may not read. A Personal key reads as its owner.
Authorizations
Path Parameters
Response
The source's kinds
A synchronized source's kinds, as the Console drawer's Completeness section shows them: whether the source is sealed, the oldest verification it accepts, and per kind its completeness now (complete, incomplete or stale, with the reason), every condition it fails (failingConditions), its last verification and failed checks, its quarantined items and how many records it holds. A source whose first pass has not completed has no kinds yet: records/list refuses its records until one completes.

