All paths below are under http://localhost:3333/api/kiwi unless you use multi-space URLs or the X-Kiwi-Space header.
Drafts return 501 Not Implemented when the server was started without a draft manager.
Create draft
Optional JSON body:
If actor is empty, the server uses X-Actor, then falls back to api.
Response 201: { "id", "branch", "actor", "created_at" }
List drafts
Returns a JSON array of draft summaries (same fields as create).
Get draft
Diff draft against main
Returns { "diff": "<unified diff text>" }.
Merge or discard
Returns { "status": "merged" }. Conflicts return 409.
Returns 204 on success.
Files inside a draft
MCP parity
Use the kiwi_draft_* tools from MCP for the same operations from Claude, Cursor, or other MCP clients. Last modified on May 14, 2026
