AddPrompt

Overview

Submits a prompt to a chapter, describing what to build. This tool waits for completion (unlike the REST API which returns immediately), making it suited for conversational workflows.

This tool polls for up to 30 seconds. If the chapter is still processing after that, you’ll get a timeout response and can poll again.

Parameters

string

required

The project ID (e.g., prj_abc123xyz)

string

required

The chapter name. The chapter is created if it doesn’t already exist.

string

required

Prompt content describing what to build (1-5000 characters)

boolean

If true, cancel any in-flight prompt for this chapter and restart (default: false)

Returns

Returns the chapter status after polling for completion.

Example Usage

In Claude

For the "Pricing Page Refresh" project, add a chapter called "Launch Ad" and build a 30-second product launch ad from our latest release notes and the new pricing screenshot.

Add a "Feature Demo" chapter that walks through the new Team plan dashboard, using the screenshots in our brand kit.

Direct Tool Call

{
  "name": "AddPrompt",
  "arguments": {
    "project_id": "prj_abc123xyz",
    "chapter_title": "Launch Ad",
    "prompt": "30-second product launch ad for the new Team plan. Pull the headline from our release notes, drop in the updated pricing screenshot, and resolve brand colors and type from the catalog.",
    "force": false
  }
}

Response (Success)

{
  "status": "completed",
  "message": "Prompt completed in 47 seconds",
  "chapter": {
    "id": "cht_def456uvw",
    "title": "Launch Ad",
    "status": "completed"
  },
  "elapsed_seconds": 47
}

Response (Timeout)

{
  "status": "processing",
  "message": "Prompt is still processing",
  "elapsed_seconds": 30,
  "chapter_id": "cht_def456uvw",
  "chapter_title": "Launch Ad",
  "hint": "Check status again in a few moments, or use force: true to restart if stuck"
}

Writing Effective Prompts

Reference real product surfaces

Build the launch chapter using the headline from our latest release notes
and the new pricing screenshot. Resolve brand from the catalog.

Include timing details

15-second social cut:
- 0-5s: hero shot of the new dashboard
- 5-10s: the headline from our release notes
- 10-15s: CTA pulled from the pricing page

Describe the output, not the magic

Product launch ad. 30 seconds. 16:9. Modern, on-brand,
confident pacing. Match the typography and accent color
in our catalog.

Reference uploaded assets

Use the pricing screenshot I uploaded earlier and the new
"Team plan" headline from the latest release note.

Common Use Cases

Building chapter content

For the "Feature Demo" chapter, walk through the new dashboard using the latest screenshots

Iterating on content

Update the launch ad to lead with the price drop instead of the new feature

Batch creation

Build content for all five chapters of the launch project

Behavior Notes

Auto-creates chapters: If a chapter with the specified title doesn’t exist, it’s created automatically.

Blocking operation: This tool waits for completion (up to 30 seconds). For longer processing times, use the REST API’s non-blocking approach.

Force parameter: force: true cancels an in-flight prompt and restarts. Use sparingly. it interrupts work in progress.

REST API Equivalent

This tool calls:

POST /api/v1/projects/{projectId}/chapters (if the chapter doesn’t exist)
POST /api/v1/projects/{projectId}/chapters/{chapterId}/prompt
Polls GET /api/v1/projects/{projectId}/chapters/{chapterId} for completion

See the Submit Prompt API documentation for more details.

Getting Started

Tools

Examples

Overview

Parameters

Returns

Example Usage

In Claude

Direct Tool Call

Response (Success)

Response (Timeout)

Writing Effective Prompts

Common Use Cases

Behavior Notes

REST API Equivalent

​Overview

​Parameters

​Returns

​Example Usage

​In Claude

​Direct Tool Call

​Response (Success)

​Response (Timeout)

​Writing Effective Prompts

​Common Use Cases

​Behavior Notes

​REST API Equivalent

Overview

Parameters

Returns

Example Usage

In Claude

Direct Tool Call

Response (Success)

Response (Timeout)

Writing Effective Prompts

Common Use Cases

Behavior Notes

REST API Equivalent