> ## 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.

# SearchFilesInput

> Input object in the GraphQL API.

Input for searching files

| Field | Type | Required | Description |
| - | - | - | - |
| `projectReference` | [`String`](/docs/cloud/graphql/types/string) | No | Project ID or slug; omit to use the context project. Explicit selection requires project.files.read. |
| `ref` | [`String`](/docs/cloud/graphql/types/string) | No | Content selector: main, branch:\<name-or-id>, release:\<version>, or env:\<name>. Omit to preserve the current content context. |
| `branch` | [`String`](/docs/cloud/graphql/types/string) | No | Branch name or ID; alias for ref=branch:\<value>. Conflicting aliases are rejected. |
| `branchId` | [`String`](/docs/cloud/graphql/types/string) | No | Legacy branch name or ID alias. |
| `query` | [`String!`](/docs/cloud/graphql/types/string) | Yes | Search query (text or regex pattern) |
| `pattern` | [`String`](/docs/cloud/graphql/types/string) | No | File path pattern filter (e.g., \*.tsx) |
| `isRegex` | [`Boolean`](/docs/cloud/graphql/types/boolean) | No | Treat query as regex (default: false) |
| `caseSensitive` | [`Boolean`](/docs/cloud/graphql/types/boolean) | No | Case sensitive search (default: false) |
| `maxResults` | [`Int`](/docs/cloud/graphql/types/int) | No | Maximum matching files, integer 1 to 100 (default 50). Limits files, not matching lines. |

[All GraphQL types](/docs/cloud/graphql/schema) · [Operations](/docs/cloud/graphql)


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