Projects
Manage projects, URLs, settings, and project resources.
Get project by slug
/organizations/{id}/projects/by-slug/{projectSlug}Retrieves the full details of a single project by its URL-friendly slug within the specified organization. This is an alternative to looking up a project by its UUID when you have the human-readable slug from a URL or user input. Returns the same complete project object as the get-by-ID endpoint including name, slug, description, settings, and timestamps.
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const { data: project } = await gc.projects.getProjectBySlug({ id: "YOUR_ID", projectSlug: "YOUR_PROJECT_SLUG"});Search project knowledge
/organizations/{id}/projects/{projectId}/searchSemantic search across all project knowledge — files, pages, posts, KB articles, developer docs, SDK methods, emails, and private CRM data. Returns the most relevant text chunks ranked by similarity, with sourceType and sourceId citations. Use the sourceId with the appropriate get endpoint (getFile, getWebsitePage, etc.) to retrieve the full source document.
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const { data: results } = await gc.projects.searchProject({ id: "your-id", projectId: "your-project-id", query: "your-search-query"});Get all project URLs
/organizations/{id}/projects/{projectId}/urlsReturns resolved relative URLs for all published content across all apps in the project. Includes pages, posts, articles, etc. with name, path, type, and SEO metadata. Used for link resolution in AI builders, menus, emails, and navigation.
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const { data: urls } = await gc.projects.getProjectUrls({ id: "id-123", projectId: "proj-123"});Get a project by ID
/organizations/{id}/projects/{projectId}Retrieves the full details of a single project by its unique ID within the specified organization. Returns the project's name, slug, description, settings, and timestamps. The project must belong to the specified organization or a 404 error is returned.
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const { data: project } = await gc.projects.getProject({ id: "YOUR_ID", projectId: "YOUR_PROJECT_ID"});Get projects in an organization
/organizations/{id}/projectsReturns a paginated list of all projects belonging to the specified organization. Projects are the top-level containers that hold apps, brandings, and domains. Supports search filtering by project name and pagination via page and pageSize query parameters. Each project in the response includes its unique ID, name, slug, description, and timestamps.
import { createGiantContext } from "@giantcontext/sdk-typescript";
const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });
const { data: projects } = await gc.projects.getProjects("id");