List knowledge files - Veryfront

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

Arguments

Argument	Type	Required	Description
`projectReference`	`ID!`	Yes	Project 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.
`input`	`KnowledgeCatalogInput`	No

Input fields

input

KnowledgeCatalogInput

Field	Type	Required	Description
`lookupTarget`	`KnowledgeLookupTargetInput`	No	Source to list; omit for the main preview branch.
`callerSelector`	`JSON`	No	Caller-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.
`filters`	`KnowledgeFiltersInput`	No
`pagination`	`KnowledgeCatalogPaginationInput`	No

Response

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

Field	Type	Description
`data`	`[KnowledgeFile!]!`
`pageInfo`	`PageInfo!`
`total`	`Int!`	Visible files at this source, across all pages.
`returned`	`Int!`

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

Example

query KnowledgeCatalog($projectReference: ID!, $input: KnowledgeCatalogInput) {
  knowledgeCatalog(projectReference: $projectReference, input: $input) {
    returned
    total
    data {
      fileId
      fileVersionId
      malformedReason
      path
      reserved
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}

{
  "projectReference": "00000000-0000-4000-8000-000000000001"
}