List knowledge files

knowledgeCatalog(projectReference: ID!, input: KnowledgeCatalogInput): KnowledgeCatalog!

Arguments

ArgumentTypeRequiredDescription
projectReferenceID!YesProject whose knowledge is selected. Ordinary callers require project.knowledge.read. A run-bound MCP service credential instead must match the persisted run's project and agent plus its actor or runtime transport binding; its effective sealed authority must grant the invoked tool and a knowledge selector. On project-scoped MCP endpoints, the scoped project supplies this value when omitted.
inputKnowledgeCatalogInputNo

Input fields

input

KnowledgeCatalogInput

FieldTypeRequiredDescription
lookupTargetKnowledgeLookupTargetInputNoSource to list; omit for the main preview branch.
callerSelectorJSONNoCaller-selected document scope. Source membership, persisted run knowledge policy and this selector are intersected before counting or paging. Results include visible knowledge Markdown files with title, type, tags and link counts. Accepts a boolean, a path pattern, a list of patterns, or a {pattern: boolean} map. Patterns are relative; at most 1024 entries.
filtersKnowledgeFiltersInputNo
paginationKnowledgeCatalogPaginationInputNo

Response

Returns KnowledgeCatalog!. Open the type for its fields and nested types.

FieldTypeDescription
data[KnowledgeFile!]!
pageInfoPageInfo!
totalInt!Visible files at this source, across all pages.
returnedInt!

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query KnowledgeCatalog($projectReference: ID!, $input: KnowledgeCatalogInput) {
  knowledgeCatalog(projectReference: $projectReference, input: $input) {
    returned
    total
    data {
      fileId
      fileVersionId
      malformedReason
      path
      reserved
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
json
{
  "projectReference": "00000000-0000-4000-8000-000000000001"
}