> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List knowledge files

> List knowledge files.

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

## Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `projectReference` | [`ID!`](https://veryfront.com/docs/cloud/graphql/types/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`](https://veryfront.com/docs/cloud/graphql/types/knowledgecataloginput) | No | |

## Input fields

### input

[`KnowledgeCatalogInput`](https://veryfront.com/docs/cloud/graphql/types/knowledgecataloginput)

| Field | Type | Required | Description |
| - | - | - | - |
| `lookupTarget` | [`KnowledgeLookupTargetInput`](https://veryfront.com/docs/cloud/graphql/types/knowledgelookuptargetinput) | No | Source to list; omit for the main preview branch. |
| `callerSelector` | [`JSON`](https://veryfront.com/docs/cloud/graphql/types/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`](https://veryfront.com/docs/cloud/graphql/types/knowledgefiltersinput) | No | |
| `pagination` | [`KnowledgeCatalogPaginationInput`](https://veryfront.com/docs/cloud/graphql/types/knowledgecatalogpaginationinput) | No | |

## Response

Returns [`KnowledgeCatalog!`](https://veryfront.com/docs/cloud/graphql/types/knowledgecatalog). Open the type for its fields and nested types.

| Field | Type | Description |
| - | - | - |
| `data` | [`[KnowledgeFile!]!`](https://veryfront.com/docs/cloud/graphql/types/knowledgefile) | |
| `pageInfo` | [`PageInfo!`](https://veryfront.com/docs/cloud/graphql/types/pageinfo) | |
| `total` | [`Int!`](https://veryfront.com/docs/cloud/graphql/types/int) | Visible files at this source, across all pages. |
| `returned` | [`Int!`](https://veryfront.com/docs/cloud/graphql/types/int) | |

Types marked with `!` cannot be null. Lists use `[Type]` notation. The [type index](https://veryfront.com/docs/cloud/graphql/schema.md) lists all published input and response types.

## Example

```graphql title="query.graphql" theme={null}
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 title="variables.json" theme={null}
{
  "projectReference": "00000000-0000-4000-8000-000000000001"
}
```

<details>
  <summary>Try this query</summary>

  Calls use `https://api.veryfront.com/graphql`. Replace sample values with resources you can access. See [Authentication](https://veryfront.com/docs/cloud/authentication.md) for credentials and permissions.

  Bearer token or API key

  Stored in this tab's session. Clear credential

  Query

  Variables (JSON)
</details>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.