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