Storyden
Nodes

Node Version Delete

Delete the working draft checkpoint. A draft author can discard their own draft. Members with `MANAGE_LIBRARY` permission can discard any draft for the node. The draft row is removed from history. Applied versions are immutable history entries and cannot be deleted through this endpoint.

DELETE/nodes/{node_slug}/versions/{version_id}

Delete the working draft checkpoint.

A draft author can discard their own draft. Members with MANAGE_LIBRARY permission can discard any draft for the node. The draft row is removed from history. Applied versions are immutable history entries and cannot be deleted through this endpoint.

Authorization

storyden-session<token>

In: cookie

Path Parameters

node_slug*string

Unique node Slug.

version_id*string

Node version ID.

Response Body

application/json

curl -X DELETE "https://example.com/nodes/cc5lnd2s1s4652adtu50/versions/cc5lnd2s1s4652adtu50"
Empty
Empty
Empty
{
  "type": "string",
  "title": "string",
  "detail": "string",
  "trace_id": "string",
  "metadata": {}
}
Edit on GitHub

Node Version Create POST

Create the single mutable draft checkpoint for a node. This operation requires either `SUBMIT_LIBRARY_NODE_CHANGES` or `MANAGE_LIBRARY` permission. The draft starts as a full snapshot of the node's current versioned page fields. Fields supplied in the request overlay that snapshot, omitted fields keep the snapshotted value, and explicit null values clear nullable fields. A node can have only one draft. If a draft already exists for the node, this operation returns a conflict. Drafts do not mutate the target node until the draft is applied through the version status endpoint by a member with `MANAGE_LIBRARY`.

Node Version Draft Get GET

Get the node's single working draft checkpoint. This is a stable alias for the draft version of a node. It allows clients to read "the draft" without listing versions and inspecting status values. If the node has no draft, or the draft is not visible to the caller, this operation returns not found. The draft is visible only to its author and members with `MANAGE_LIBRARY`.