Knowledge
List knowledge subject collections
List the subject collections in your readable namespaces, each with how many of its artifacts you can read. Requires knowledge:read.
GET
List knowledge subject collections
The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.
v2 compatibility notes
GET /api/v2/knowledge/subjectCollections/list lists the subject collections in the credential’s readable namespaces, or in the one namespace names. A subject collection records what a prose artifact is about; it never grants or narrows access. MCP hosts call it through forge_call_operation with operationId listKnowledgeSubjectCollections. It needs knowledge:read.
A collection is listed only where the caller reads knowledge; for a Personal key, that means where its owner reads knowledge. A namespace the caller cannot read answers 403 forbidden, recorded.
The response is { data: { status, collections }, meta }. Each collection carries its collectionId, namespace, name, an optional parentCollectionId, and artifactCount. The count includes only the filed artifacts the caller can read. It never counts:
- a record;
- an artifact waiting for review;
- a source-restricted artifact.
collectionId.
The read is bounded:
artifactCountIsPartial: truemarks a count that stopped at the read budget; that count is then a floor.status: "too_large"means a namespace holds more collections than one read loads.meta.partialistruein either case.
Authorizations
Query Parameters
Response
One page of subject collections

