GitBook Review Flow (direct API)

Run a documentation review loop against a GitBook space entirely through the GitBook REST API (https://api.gitbook.com/v1, hit with curl), so an engineer never has to leave Claude Code (plus Slack) to propose docs changes and get them reviewed. This is the authoring-side companion to cr-review (the reviewer side over the same API). Every action here is a plain HTTP call — there is no CLI and no helper script.

The same actions serve three purposes with no separate code paths:

• CR-creation demo — create a change request and push content (one existing page updated, one new page created).
• Notify/review demo — request reviewers, drop a Slack link, pull comments, fix, re-push, resolve.
• Real use — the identical actions against the user's own content.

Because the demo is just a scripted sequence of the real actions, it cannot show something that doesn't actually work. Keep it that way: never fake an output.

Auth and the gbapi helper