Project Apps

Create, configure, restore, and delete project apps.

GET

Get a project app by slug

/organizations/{id}/projects/{projectId}/apps/by-slug/{appSlug}

Retrieves the full details of a single app by its URL-friendly slug within the specified project. This is an alternative to looking up an app by ID when you have the human-readable slug instead. Returns the same complete app object as the get-by-ID endpoint including name, slug, app type, configuration, and timestamps.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

appSlugRequired

path · stringApp slug

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const id = "example-id";6const projectId = "example-project-id";7const appSlug = "example-app-slug";8
9const { data: projectApp } = await gc.projectApps.getProjectAppBySlug({10  id,11  projectId,12  appSlug13});

GET

Get a project app by ID

/organizations/{id}/projects/{projectId}/apps/{appId}

Retrieves the full details of a single app by its unique ID within the specified project. Returns the app's name, slug, app type, configuration settings, and timestamps. The app must belong to the specified project or a 404 error is returned.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

appIdRequired

path · stringApp ID

SDK

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

GET

Get deleted apps in trash

/organizations/{id}/projects/{projectId}/apps/trash

Returns a list of all soft-deleted (trashed) apps within the specified project. These are apps that have been deleted but not yet permanently removed. Each app includes its full details including name, slug, app type, and deletion timestamp. Trashed apps can be restored using the restore endpoint or permanently deleted using the permanent delete endpoint.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

SDK

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

GET

Get apps in a project

/organizations/{id}/projects/{projectId}/apps

Returns a paginated list of all active (non-deleted) apps configured within the specified project. Apps represent individual applications such as websites, CRM instances, email campaigns, forms, knowledge bases, or chat widgets. Each app includes its unique ID, name, slug, app type, configuration, and timestamps. Supports pagination and search filtering.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

SDK

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

Built byHuman

This content was designed and written by a human.