Drafts

Generate, edit, preview, and publish content drafts.

POST

Generate AI content draft

/drafts/generate

Generates an AI content draft from a natural language prompt. Creates a system service account if needed, mints an ephemeral JWT, and calls the AI service. The resulting draft can be reviewed and accepted or rejected via the drafts API.

BodyRequired

appId

string

items

array

promptRequired

string

draftId

string

projectIdRequired

string

resourceId

string

contentType

string

organizationIdRequired

string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const data = {6  prompt: "Example prompt"7};8
9const { data: draft } = await gc.drafts.generateDraft(data);

POST

Create an edit draft

/drafts/edit

Creates a draft copy of existing content for non-destructive editing. The original stays untouched until the draft is accepted. On accept, the copy's content replaces the original. On reject, the copy is deleted.

BodyRequired

prompt

string

projectIdRequired

string

resourceIdRequired

string

contentTypeRequired

string

organizationIdRequired

string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const data = {};6const { data: draft } = await gc.drafts.editDraft(data);

POST

Unarchive a draft

/organizations/{id}/projects/{projectId}/mind/drafts/{draftId}/unarchive

Restores a previously archived draft to the default list.

Parameters

idRequired

path · string

projectIdRequired

path · string

draftIdRequired

path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: draft } = await gc.drafts.unarchiveDraft({6  id: "id-123",7  projectId: "proj-123",8  draftId: "draft-123"9});

POST

Archive a draft

/organizations/{id}/projects/{projectId}/mind/drafts/{draftId}/archive

Hides an accepted draft from the default list without deleting it. Archived drafts are preserved as a paper trail and for AI training data. Only accepted or partially_accepted drafts can be archived.

Parameters

idRequired

path · string

projectIdRequired

path · string

draftIdRequired

path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: draft } = await gc.drafts.archiveDraft({6  id: "id-1",7  projectId: "proj-1",8  draftId: "draft-1"9});

GET

Get a draft by ID

/organizations/{id}/projects/{projectId}/mind/drafts/{draftId}

Retrieves the full details of a single AI-generated content draft including the prompt, generated content, tool calls, and sources.

Parameters

idRequired

path · string

projectIdRequired

path · string

draftIdRequired

path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { data: draft } = await gc.drafts.getDraft({6  id: "id_123",7  projectId: "proj_123",8  draftId: "draft_123"9});

DELETE

Delete a draft

/organizations/{id}/projects/{projectId}/mind/drafts/{draftId}

Permanently deletes a draft. Only rejected, failed, or cancelled drafts can be deleted. Returns 409 if the draft is in any other status (pending, ready, accepted).

Parameters

idRequired

path · string

projectIdRequired

path · string

draftIdRequired

path · string

SDK

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

GET

List drafts for a project

/organizations/{id}/projects/{projectId}/mind/drafts

Returns a paginated list of AI-generated content drafts for the specified project. By default archived drafts are hidden — pass includeArchived=true to include them.

Parameters

page

query · number

pageSize

query · number

lite

query · stringWhen 'true', return only essential fields (id, slug, title/name). Useful for context fetching, link resolution, and reducing payload size.

includeArchived

query · unionWhen true, archived drafts are included. Default: false.

idRequired

path · string

projectIdRequired

path · string

SDK

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

Built byHuman

This content was designed and written by a human.