Skip to main content

Overview

Adds a new chapter to an existing video project. Chapters are segments of your video with individual content and duration.

Parameters

project_id
string
required
The project ID (e.g., prj_abc123xyz)
name
string
required
Chapter name (1-30 characters)
duration
number
Optional duration in seconds (must be positive integer)

Returns

Returns the created chapter with its unique ID.

Example Usage

In Claude

Add a 30-second intro chapter to project prj_abc123xyz
Create chapters for my video: Intro (15s), Main Content (60s), Outro (10s)

Direct Tool Call

{
  "name": "AddChapter",
  "arguments": {
    "project_id": "prj_abc123xyz",
    "name": "Introduction",
    "duration": 30
  }
}

Response

{
  "id": "cht_def456uvw",
  "project_id": "prj_abc123xyz",
  "name": "Introduction",
  "duration": 30,
  "created_at": "2025-12-02T10:01:00Z"
}

Common Use Cases

Add a chapter called "Tutorial" to my project
Create these chapters: Introduction, Features, Pricing, Call to Action
Add a 45-second chapter called "Product Demo"

Next Steps

After adding chapters:

REST API Equivalent

This tool calls: POST /api/v1/projects/{projectId}/chapters See the Create Chapter API documentation for more details.