Projects API - Veryfront

For API groups, see Projects API.

Queries

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

Mutations

Operation	Description
`addFavorite`	Adds your favorite association, returning the existing record when already present.
`approveBranch`	Records the caller’s approval of a branch.
`commitDraftContent`	Commit one file to an immutable content version.
`commitFiles`	Commit pending edits/deletions/renames independently.
`createAccountProject`	Create and assign a project atomically.
`createBranch`	Creates a project branch from the selected source.
`createBranchPolicy`	Creates a branch protection policy for a project.
`createFile`	Create textual source in main or the selected branch.
`createFileUploadUrl`	Creates a signed URL for uploading file content.
`createProject`	Create an owned project.
`createProjectLabel`	Create a project label.
`createUploadFolder`	Create a folder or update its visibility.
`createUploadUrl`	Generate a signed URL for file upload
`deleteBranch`	Delete a branch with a base branch, excluding main.
`deleteBranchPolicy`	Delete a branch policy.
`deleteDraftContent`	Discard pending updates without deleting the committed source file.
`deleteFile`	Append a deletion version in main or the selected branch; immutable history remains.
`deleteProject`	Permanently delete the project.
`deleteProjectLabel`	Soft-delete an active label in this project.
`deleteUpload`	Soft-delete an uploaded file.
`deleteUploadFolder`	Remove folder visibility settings, child folder settings, and soft-delete files under the folder prefix.
`dismissApproval`	Soft-dismiss a branch approval while retaining its audit fields.
`ensureCurrentStyleArtifactBuild`	Reuse or enqueue a style build.
`mergeBranch`	Merges a branch into the selected target branch.
`moveFile`	Move a file in main or the selected branch.
`moveUpload`	Move an uploaded file to a new location
`removeFavorite`	Removes your favorite association; returns false when no association exists.
`removePathVisibility`	Remove visibility setting for a path (reverts to inherited/default)
`renameUploadFolder`	Move a folder, its child visibility settings and active files to an unused destination.
`replaceUploadGrants`	Replace the entire grant list on the resolved upload or folder target.
`resolveProjectDependencies`	Resolve and pin npm dependencies into package.json.
`restoreUpload`	Restore an existing soft-deleted upload record.
`revokeGrant`	Revoke a user’s access grant from a path.
`setGrant`	Grant or update a user’s access to a path.
`setPathVisibility`	Set or update visibility for a path (folder prefix or file).
`toggleFavorite`	Adds or removes your favorite association and returns the resulting state.
`updateDraftContent`	Replace an existing source file’s pending full-body draft and return its current sequence.
`updateFile`	Replace existing textual source in main or the selected branch with a new immutable version.
`updateProject`	Update supplied project fields and config members.
`updateProjectLabel`	Replace an active project label.
`updateStatusCheck`	Creates or updates a branch status-check result.
`upsertCurrentStyleArtifact`	Register metadata without uploading CSS.