Update an outline

Edits the outline in place — this is the review step the retired /gpt flow had no equivalent for. Send chapters to replace the chapter set, or drafts for finer control; both write to outline.drafts, so sending both is rejected. Unknown fields are rejected.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Edits the outline in place. This is the review step the retired /gpt flow had no equivalent for —
you can restructure the plan before any video exists, which is far cheaper than fixing slides
afterwards.

Send chapters to replace the whole chapter set, or drafts for finer control over individual
entries.

🚧

chapters and drafts are mutually exclusive

Both write to outline.drafts, so sending both is rejected with 400. The request must also
change at least one of chapters, drafts, quizSettings or status — an empty update is an
error, not a no-op.

Unknown fields are rejected rather than ignored, so a typo fails loudly instead of silently doing
nothing.

Limits: at most 128 points per chapter, 1024 characters per title or point.

Path Params
string
required

Id of the outline.

Body Params

At least one of chapters, drafts, quizSettings or status is required.

chapters
array of objects

Replaces the chapter set. Mutually exclusive with drafts.

chapters
drafts
array of objects

Replaces the drafts. Mutually exclusive with chapters.

drafts
quizSettings
string
enum
Allowed:
Responses

chapters and drafts sent, nothing to update, or an unknown field was included.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json