Returns a comprehensive list of all entities that reference this file across the project. This includes pages, headers, footers, blog posts, templates, sidebars, dialogs, forms, and branding settings. Useful for understanding the impact of deleting or replacing a file.

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: fileReferences } = await gc.projectFiles.getFileReferences({6  id: "example-id",7  projectId: "example-project-id",8  fileId: "example-file-id"9});

Retrieves the details of a single folder in the project file manager, including its name, parent folder ID, and creation metadata.

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: fileFolder } = await gc.projectFiles.getFileFolder({6  id: "file-id",7  projectId: "project-id",8  folderId: "folder-id"9});

Replaces the content of an existing text file. The file must be a text-based type (Markdown, plain text, CSV, JSON, YAML, HTML, CSS, JS, XML, SVG). The file's storage object is overwritten, its size is updated, and AI embeddings are re-generated from the new content. The file ID, URL, metadata, and all references remain unchanged.

1curl -X PUT "https://api.giantcontext.com/organizations/id_uuid/projects/projectId_uuid/files/fileId_uuid/content" \2  -H "Authorization: Bearer $API_KEY" \3  -H "Content-Type: application/json" \4  -d '{5  "content": "content_value"6}'

Returns the actual content of a file inline — text as a string, images as base64. Use this when you need to read or analyze a file's content rather than just its metadata. Text files (Markdown, CSV, JSON, YAML, plain text, HTML, CSS, JS, XML, SVG) are returned in the 'content' field. Image files (PNG, JPG, GIF, WebP) are returned as base64 in the 'base64Content' field. Files over 10 MB or unsupported types return 404.

1curl -X GET "https://api.giantcontext.com/organizations/id_uuid/projects/projectId_uuid/files/fileId_uuid/open" \2  -H "Authorization: Bearer $API_KEY"

Retrieves the full details of a single file in the project file manager, including its filename, MIME type, size, dimensions, storage URL, alt text, caption, and folder assignment.

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: file } = await gc.projectFiles.getFile({6  id: "YOUR_ID",7  projectId: "YOUR_PROJECT_ID",8  fileId: "YOUR_FILE_ID"9});

Returns all folders in the project file manager. Optionally filter by parentId to list only child folders of a specific parent folder. Pass parentId='null' or omit it to list root-level folders. Folders are used to organize uploaded files (images, documents, media).

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: fileFolders } = await gc.projectFiles.getFileFolders({6  id: "file-id",7  projectId: "project-id"8});

Searches project files by their content using semantic/AI search. Returns files whose content matches the meaning of the query, along with the matching content snippet and a relevance score.

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: results } = await gc.projectFiles.searchProjectFiles({6  id: "your-file-id",7  projectId: "your-project-id",8  query: "your-search-query"9});

Returns all soft-deleted files and folders currently in the project's file trash. Items remain in trash until they are restored or permanently deleted. Each item includes its original metadata and the date it was trashed.

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: trash } = await gc.projectFiles.listFileTrash({6  id: "file-id",7  projectId: "project-id"8});

Saves a file to the project from raw text content (Markdown, Mermaid, CSV, JSON, YAML, plain text, etc.) or base64-encoded image data (PNG, JPG, GIF, WebP, SVG). The file is stored in the project and processed for AI embeddings (text) or image classification (images). Use this to save documents, notes, diagrams, structured data, or screenshots into the project knowledge base.

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: file } = await gc.projectFiles.saveFile({6  id: "file_123",7  projectId: "proj_123",8  data: "file_content"9});