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

# Projects API

> Create projects and manage source files, branches, and uploads.

For API groups, see [Projects API](/docs/cloud/apis/projects).

## Queries

| Operation | Description |
| - | - |
| [`accountProjects`](/docs/cloud/graphql/operations/projects-api/queries/accountprojects) | List account projects newest first. |
| [`branch`](/docs/cloud/graphql/operations/projects-api/queries/branch) | Returns a project branch. |
| [`branchApprovalCollection`](/docs/cloud/graphql/operations/projects-api/queries/branchapprovalcollection) | Read branch approvals in ID ascending order. |
| [`branchApprovals`](/docs/cloud/graphql/operations/projects-api/queries/branchapprovals) | Lists approvals recorded for a project branch. |
| [`branchCollection`](/docs/cloud/graphql/operations/projects-api/queries/branchcollection) | Read persisted branches in ID ascending order. |
| [`branches`](/docs/cloud/graphql/operations/projects-api/queries/branches) | Lists project branches. |
| [`branchPolicies`](/docs/cloud/graphql/operations/projects-api/queries/branchpolicies) | Lists branch protection policies for a project. |
| [`branchPolicyCollection`](/docs/cloud/graphql/operations/projects-api/queries/branchpolicycollection) | Read branch policies in ID ascending order. |
| [`branchStatusCheckCollection`](/docs/cloud/graphql/operations/projects-api/queries/branchstatuscheckcollection) | Read branch status checks in ID ascending order. |
| [`currentStyleArtifact`](/docs/cloud/graphql/operations/projects-api/queries/currentstyleartifact) | Read current ready, building, failed, or missing metadata. |
| [`draftContent`](/docs/cloud/graphql/operations/projects-api/queries/draftcontent) | Read a pending draft by file path/UUID. |
| [`draftFiles`](/docs/cloud/graphql/operations/projects-api/queries/draftfiles) | List one latest pending update per canonically visible source file. |
| [`fileDiff`](/docs/cloud/graphql/operations/projects-api/queries/filediff) | Read a unified diff against a source version; branch selectors default to main. |
| [`files`](/docs/cloud/graphql/operations/projects-api/queries/files) | List metadata only. |
| [`fileVersion`](/docs/cloud/graphql/operations/projects-api/queries/fileversion) | Read committed file content by version UUID or newest-first index. |
| [`fileVersions`](/docs/cloud/graphql/operations/projects-api/queries/fileversions) | List committed main or branch file history with opaque continuation cursors. |
| [`findTemplate`](/docs/cloud/graphql/operations/projects-api/queries/findtemplate) | Find the best template for a given user intent using AI |
| [`getFiles`](/docs/cloud/graphql/operations/projects-api/queries/getfiles) | Read selected file content in input order; missing and restricted files are omitted. |
| [`getUpload`](/docs/cloud/graphql/operations/projects-api/queries/getupload) | Read one upload's metadata without signing a storage URL. |
| [`getUploadSignedUrl`](/docs/cloud/graphql/operations/projects-api/queries/getuploadsignedurl) | Get a signed URL for downloading a file (30min for private, 24h for public) |
| [`isFavorite`](/docs/cloud/graphql/operations/projects-api/queries/isfavorite) | Checks your favorite association for the selected accessible project. |
| [`listUploadGrants`](/docs/cloud/graphql/operations/projects-api/queries/listuploadgrants) | List all grants on the resolved upload or folder visibility target. |
| [`listUploads`](/docs/cloud/graphql/operations/projects-api/queries/listuploads) | List visible uploaded files with selectable sorting (default: creation-time descending). |
| [`mergeEligibility`](/docs/cloud/graphql/operations/projects-api/queries/mergeeligibility) | Checks branch approvals, status checks, and policies to determine merge eligibility. |
| [`mergePreview`](/docs/cloud/graphql/operations/projects-api/queries/mergepreview) | Returns the changes that a branch merge would apply. |
| [`myFavorites`](/docs/cloud/graphql/operations/projects-api/queries/myfavorites) | Lists your favorite records and project IDs. |
| [`project`](/docs/cloud/graphql/operations/projects-api/queries/project) | Read a project by UUID. |
| [`projectByDomain`](/docs/cloud/graphql/operations/projects-api/queries/projectbydomain) | Read the project associated with a domain. |
| [`projectBySlug`](/docs/cloud/graphql/operations/projects-api/queries/projectbyslug) | Read an accessible project by slug. |
| [`projectDependencyHistory`](/docs/cloud/graphql/operations/projects-api/queries/projectdependencyhistory) | Read bounded, unexpired raw dependency declaration history for a project and branch. |
| [`projectLabels`](/docs/cloud/graphql/operations/projects-api/queries/projectlabels) | List all active project labels, ordered by namespace, key and value. |
| [`projects`](/docs/cloud/graphql/operations/projects-api/queries/projects) | List projects accessible to the caller. |
| [`projectSearch`](/docs/cloud/graphql/operations/projects-api/queries/projectsearch) | Search the caller's projects by name or slug. |
| [`searchFiles`](/docs/cloud/graphql/operations/projects-api/queries/searchfiles) | Search for text patterns within file contents |
| [`statusChecks`](/docs/cloud/graphql/operations/projects-api/queries/statuschecks) | Lists status checks recorded for a project branch. |
| [`templates`](/docs/cloud/graphql/operations/projects-api/queries/templates) | List a page of curated templates visible to the authenticated user. |

## Mutations

| Operation | Description |
| - | - |
| [`addFavorite`](/docs/cloud/graphql/operations/projects-api/mutations/addfavorite) | Adds your favorite association, returning the existing record when already present. |
| [`approveBranch`](/docs/cloud/graphql/operations/projects-api/mutations/approvebranch) | Records the caller’s approval of a branch. |
| [`commitDraftContent`](/docs/cloud/graphql/operations/projects-api/mutations/commitdraftcontent) | Commit one file to an immutable content version. |
| [`commitFiles`](/docs/cloud/graphql/operations/projects-api/mutations/commitfiles) | Commit pending edits/deletions/renames independently. |
| [`createAccountProject`](/docs/cloud/graphql/operations/projects-api/mutations/createaccountproject) | Create and assign a project atomically. |
| [`createBranch`](/docs/cloud/graphql/operations/projects-api/mutations/createbranch) | Creates a project branch from the selected source. |
| [`createBranchPolicy`](/docs/cloud/graphql/operations/projects-api/mutations/createbranchpolicy) | Creates a branch protection policy for a project. |
| [`createFile`](/docs/cloud/graphql/operations/projects-api/mutations/createfile) | Create textual source in main or the selected branch. |
| [`createFileUploadUrl`](/docs/cloud/graphql/operations/projects-api/mutations/createfileuploadurl) | Creates a signed URL for uploading file content. |
| [`createProject`](/docs/cloud/graphql/operations/projects-api/mutations/createproject) | Create an owned project. |
| [`createProjectLabel`](/docs/cloud/graphql/operations/projects-api/mutations/createprojectlabel) | Create a project label. |
| [`createUploadFolder`](/docs/cloud/graphql/operations/projects-api/mutations/createuploadfolder) | Create a folder or update its visibility. |
| [`createUploadUrl`](/docs/cloud/graphql/operations/projects-api/mutations/createuploadurl) | Generate a signed URL for file upload |
| [`deleteBranch`](/docs/cloud/graphql/operations/projects-api/mutations/deletebranch) | Delete a branch with a base branch, excluding main. |
| [`deleteBranchPolicy`](/docs/cloud/graphql/operations/projects-api/mutations/deletebranchpolicy) | Delete a branch policy. |
| [`deleteDraftContent`](/docs/cloud/graphql/operations/projects-api/mutations/deletedraftcontent) | Discard pending updates without deleting the committed source file. |
| [`deleteFile`](/docs/cloud/graphql/operations/projects-api/mutations/deletefile) | Append a deletion version in main or the selected branch; immutable history remains. |
| [`deleteProject`](/docs/cloud/graphql/operations/projects-api/mutations/deleteproject) | Permanently delete the project. |
| [`deleteProjectLabel`](/docs/cloud/graphql/operations/projects-api/mutations/deleteprojectlabel) | Soft-delete an active label in this project. |
| [`deleteUpload`](/docs/cloud/graphql/operations/projects-api/mutations/deleteupload) | Soft-delete an uploaded file. |
| [`deleteUploadFolder`](/docs/cloud/graphql/operations/projects-api/mutations/deleteuploadfolder) | Remove folder visibility settings, child folder settings, and soft-delete files under the folder prefix. |
| [`dismissApproval`](/docs/cloud/graphql/operations/projects-api/mutations/dismissapproval) | Soft-dismiss a branch approval while retaining its audit fields. |
| [`ensureCurrentStyleArtifactBuild`](/docs/cloud/graphql/operations/projects-api/mutations/ensurecurrentstyleartifactbuild) | Reuse or enqueue a style build. |
| [`mergeBranch`](/docs/cloud/graphql/operations/projects-api/mutations/mergebranch) | Merges a branch into the selected target branch. |
| [`moveFile`](/docs/cloud/graphql/operations/projects-api/mutations/movefile) | Move a file in main or the selected branch. |
| [`moveUpload`](/docs/cloud/graphql/operations/projects-api/mutations/moveupload) | Move an uploaded file to a new location |
| [`removeFavorite`](/docs/cloud/graphql/operations/projects-api/mutations/removefavorite) | Removes your favorite association; returns false when no association exists. |
| [`removePathVisibility`](/docs/cloud/graphql/operations/projects-api/mutations/removepathvisibility) | Remove visibility setting for a path (reverts to inherited/default) |
| [`renameUploadFolder`](/docs/cloud/graphql/operations/projects-api/mutations/renameuploadfolder) | Move a folder, its child visibility settings and active files to an unused destination. |
| [`replaceUploadGrants`](/docs/cloud/graphql/operations/projects-api/mutations/replaceuploadgrants) | Replace the entire grant list on the resolved upload or folder target. |
| [`resolveProjectDependencies`](/docs/cloud/graphql/operations/projects-api/mutations/resolveprojectdependencies) | Resolve and pin npm dependencies into package.json. |
| [`restoreUpload`](/docs/cloud/graphql/operations/projects-api/mutations/restoreupload) | Restore an existing soft-deleted upload record. |
| [`revokeGrant`](/docs/cloud/graphql/operations/projects-api/mutations/revokegrant) | Revoke a user's access grant from a path. |
| [`setGrant`](/docs/cloud/graphql/operations/projects-api/mutations/setgrant) | Grant or update a user's access to a path. |
| [`setPathVisibility`](/docs/cloud/graphql/operations/projects-api/mutations/setpathvisibility) | Set or update visibility for a path (folder prefix or file). |
| [`toggleFavorite`](/docs/cloud/graphql/operations/projects-api/mutations/togglefavorite) | Adds or removes your favorite association and returns the resulting state. |
| [`updateDraftContent`](/docs/cloud/graphql/operations/projects-api/mutations/updatedraftcontent) | Replace an existing source file's pending full-body draft and return its current sequence. |
| [`updateFile`](/docs/cloud/graphql/operations/projects-api/mutations/updatefile) | Replace existing textual source in main or the selected branch with a new immutable version. |
| [`updateProject`](/docs/cloud/graphql/operations/projects-api/mutations/updateproject) | Update supplied project fields and config members. |
| [`updateProjectLabel`](/docs/cloud/graphql/operations/projects-api/mutations/updateprojectlabel) | Replace an active project label. |
| [`updateStatusCheck`](/docs/cloud/graphql/operations/projects-api/mutations/updatestatuscheck) | Creates or updates a branch status-check result. |
| [`upsertCurrentStyleArtifact`](/docs/cloud/graphql/operations/projects-api/mutations/upsertcurrentstyleartifact) | Register metadata without uploading CSS. |


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