Get a knowledge scope's shape
Read one knowledge namespace you can read, with how many entries of each content type you may read in it and the record kinds you can list there. Requires knowledge:read.
v2 compatibility notes
GET /api/v2/knowledge/scopes/get?namespace=<namespace> reads one namespace from scopes/list with its shape, so a client can see what a namespace holds before it lists anything. It needs knowledge:read. MCP hosts call it through forge_call_operation with operationId getKnowledgeScope.
The body is the scope as scopes/list names it, { namespace, scopeType, entityId, label, readable, writable }, plus:
contentTypes:{ contentType, count }for each content type with at least one active entry you may read, in the orderdocument,message,workflow_output,note,session_summary,file,moment,snippet,case,record. A count is exactly whatcases/listreturns for that namespace andcontentType: a source-restricted entry, an artifact waiting for a steward’s review and a pending revision are never counted, so no number describes knowledge you cannot read.recordKinds:{ kind, sourceId, collectionId }for each record kind you can list there, from a synchronized source you can read (sourceId) or an authored collection you are admitted to (collectionId); the other id isnull. Pass the kind and that id toPOST /api/v2/knowledge/records/list.
meta.partial is true and each count is a floor. A namespace you cannot read and one that does not exist answer the same 404 resource_missing. namespace is required and appears once; a missing, empty or repeated namespace, or any other query parameter, answers 400 bad_request.
Authorizations
Path Parameters
Response
The scope and its shape
One readable knowledge scope as scopes/list names it, with how many active entries of each content type the caller may read in it (a type with none is left out) and the record kinds it can list there, each with the sourceId or collectionId that provides it (pass it to records/list). A count is exactly what cases/list returns for that namespace and type: a source-restricted entry, an artifact held for review and a pending revision are never counted. meta.partial says the read budget stopped the read, so each count is a floor.

