draft

move the current user's draft-only item to another path

Changed on

Relocates the authed user's own draft row, along with both path keys inside its value (the typed path and the mirror the editors keep beside it). Only for draft-only items — a deployed item must be moved through its own deploy endpoint, which carries every draft with it. Restricted to script, flow, app and raw_app; any other kind is rejected with 400, because only these keep their deploy target where this endpoint rewrites it.

post/w/{workspace}/drafts/move/{kind}/{path}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/w/{workspace}/drafts/move/{kind}/{path}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

workspacestring required
kind'script' | 'flow' | 'app' | 'raw_app' required

script, flow, app or raw_app only.

pathstring required

Request body

new_pathstring required
summarystring

Also restate the draft's summary.

Response

move result

Changes