Ideas

Manage project ideas and approval workflows.

POST

Approve a Mind idea

/organizations/{id}/projects/{projectId}/mind/ideas/{ideaId}/approve

Approve an idea, which sets its status to 'approved'. Email sends and focused email edits enqueue durable materialization contracts; other content types trigger draft generation automatically. The idea must be in 'pending' status.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

ideaIdRequired

path · stringIdea ID

BodyRequired

prompt

stringOverride the prompt for draft generation. Defaults to the idea rationale + outline.

contentType

stringOverride the content type for draft generation (e.g., website_page, kb_article).

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 ideaId = "example-idea-id";8const data = {};9
10const { data: approvedIdea } = await gc.ideas.approveIdea({11  id,12  projectId,13  ideaId,14  data15});

POST

Dismiss a Mind idea

/organizations/{id}/projects/{projectId}/mind/ideas/{ideaId}/dismiss

Dismiss an idea that the user doesn't want to pursue. The idea must be in 'pending' status. Optionally include a reason for dismissal. Dismissed ideas are tracked so Mind doesn't re-suggest them.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

ideaIdRequired

path · stringIdea ID

BodyRequired

reason

stringOptional reason for dismissing the idea.

SDK

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

GET

Get a Mind idea

/organizations/{id}/projects/{projectId}/mind/ideas/{ideaId}

Returns full details of a Mind idea including title, rationale, outline, priority, similarity score, and status. If the idea has status 'pending', it can be approved (triggering draft generation) or dismissed.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

ideaIdRequired

path · stringIdea ID

SDK

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

GET

List Mind ideas for a project

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

Returns a paginated list of Mind ideas for the project. Ideas represent content gaps or suggestions identified by the AI ideation engine. Filter by status to see pending, approved, dismissed, or drafted ideas.

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.

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: ideas } = await gc.ideas.listIdeas({6  id: "idea-id",7  projectId: "project-id"8});

POST

Trigger Mind ideation for a project

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

Enqueues a durable Mind ideation contract for this project. Optional 'target' narrows execution to one (contentType, operationKey) operation — useful for targeted testing. Returns the run and contract IDs immediately.

Parameters

idRequired

path · stringOrganization ID

projectIdRequired

path · stringProject ID

BodyRequired

target

objectOptional narrow-scope filter — run only one operation ideator for targeted testing.

SDK

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

Built byHuman

This content was designed and written by a human.