Drafts

Generate, edit, preview, and publish content drafts.

POST

Unarchive a draft back into the default list; already-unarchived is a no-op

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

Parameters

organizationIdRequired: 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 { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const result = await gc.drafts.unarchiveDraft({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11  draftId: "draft-123",12});13

POST

Archive an accepted draft to hide it from the default list without deleting

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

Parameters

organizationIdRequired: 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 { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const result = await gc.drafts.archiveDraft({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11  draftId: "draft_123",12});13

POST

Generate AI edits to existing content; async, returns a pending draftId to poll

/organizations/{organizationId}/projects/{projectId}/drafts/generate/edit

Parameters

organizationIdRequired: path · string
projectIdRequired: path · string

BodyRequired

appId: string
promptRequired: string
packageId: string
resourceIdRequired: string
contentType: string
dependencies: array
draftPackage: object

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const { draft } = await gc.drafts.generateEditDraft({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11  data: {},12});13

GET

Get one draft with its prompt, generated content and status; poll while pending

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

Parameters

lite: query · string
organizationIdRequired: 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 { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7const { drafts } = await gc.drafts.listDrafts({8  organizationId: orgs[0].id,9  projectId: projects[0].id,10});11
12const { draft } = await gc.drafts.getDraft({13  organizationId: orgs[0].id,14  projectId: projects[0].id,15  draftId: drafts[0].id,16});17

DELETE

Delete a rejected, failed or cancelled draft permanently; other statuses return 409

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

Parameters

organizationIdRequired: 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 { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const result = await gc.drafts.deleteDraft({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11  draftId: "draft-id",12});13

POST

Generate new content from a prompt; async, takes 5-15 minutes, nothing publishes yet

/organizations/{organizationId}/projects/{projectId}/drafts/generate/new

Parameters

organizationIdRequired: path · string
projectIdRequired: path · string

BodyRequired

appId: string
promptRequired: string
packageId: string
resourceId: any
contentType: string
dependencies: array
draftPackage: object
featuredContent: object

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const { draft } = await gc.drafts.generateNewDraft({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11  data: {}12});13

POST

Create a copy-on-write draft of existing content for manual editing, no AI

/organizations/{organizationId}/projects/{projectId}/drafts/edit

Parameters

organizationIdRequired: path · string
projectIdRequired: path · string

BodyRequired

prompt: string
resourceIdRequired: string
contentTypeRequired: string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const draft = await gc.drafts.createEditDraft({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11  data: {}12});13

GET

List a project's drafts newest first; archived hidden unless includeArchived

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

Parameters

page: query · number
pageSize: query · number
lite: query · string
sort: query · string
search: query · string
status: query · string
name: query · string
prompt: query · string
contentType: query · string
createdAt: query · string
updatedAt: query · string
includeArchived: query · union
organizationIdRequired: path · string
projectIdRequired: path · string

SDK

1import { createGiantContext } from "@giantcontext/sdk-typescript";2
3const gc = createGiantContext({ apiKey: process.env.GIANTCONTEXT_API_KEY! });4
5const { organizations: orgs } = await gc.me.listMyOrganizations();6const { projects } = await gc.projects.listProjects({ organizationId: orgs[0].id });7
8const { drafts } = await gc.drafts.listDrafts({9  organizationId: orgs[0].id,10  projectId: projects[0].id,11});12

BuiltAutonomously With AI

This content was built autonomously. Giant Context analyzed the site, determined what was missing, created and submitted an idea and draft, which Giant Context staff accepted and published.