Storyden
Nodes

Node Version List

List edit versions for a node. Versions have two states: draft and applied. A version is a draft when it is pre-published. There can only be a single draft of a node. Applied versions are immutable historical snapshots of the page fields that were copied into the node. The single draft version, when present, is the working snapshot ahead of the live node and is visible only to its author and members with `MANAGE_LIBRARY`. Results are ordered by `updated_at` descending so draft autosaves and recently applied checkpoints appear before older history.

GET/nodes/{node_slug}/versions

List edit versions for a node.

Versions have two states: draft and applied. A version is a draft when it is pre-published. There can only be a single draft of a node.

Applied versions are immutable historical snapshots of the page fields that were copied into the node. The single draft version, when present, is the working snapshot ahead of the live node and is visible only to its author and members with MANAGE_LIBRARY.

Results are ordered by updated_at descending so draft autosaves and recently applied checkpoints appear before older history.

Authorization

storyden-session<token>

In: cookie

Path Parameters

node_slug*string

Unique node Slug.

Query Parameters

page?string

Pagination query parameters.

Response Body

application/json

application/json

curl -X GET "https://example.com/nodes/cc5lnd2s1s4652adtu50/versions"
{
  "page_size": 0,
  "results": 0,
  "total_pages": 0,
  "current_page": 0,
  "next_page": 0,
  "versions": [
    {
      "id": "cc5lnd2s1s4652adtu50",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "node_id": "cc5lnd2s1s4652adtu50",
      "author": {
        "id": "cc5lnd2s1s4652adtu50",
        "joined": "2019-08-24T14:15:22Z",
        "suspended": "2019-08-24T14:15:22Z",
        "handle": "Southclaws",
        "name": "Barnaby Keene",
        "signature": "<body><p>Sent with love from London!</p></body>",
        "roles": [
          {
            "badge": true,
            "default": true,
            "id": "cc5lnd2s1s4652adtu50",
            "name": "string",
            "colour": "string",
            "meta": {}
          }
        ]
      },
      "status": "draft",
      "previous": {
        "id": "cc5lnd2s1s4652adtu50",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "author": {
          "id": "cc5lnd2s1s4652adtu50",
          "joined": "2019-08-24T14:15:22Z",
          "suspended": "2019-08-24T14:15:22Z",
          "handle": "Southclaws",
          "name": "Barnaby Keene",
          "signature": "<body><p>Sent with love from London!</p></body>",
          "roles": [
            {
              "badge": true,
              "default": true,
              "id": "cc5lnd2s1s4652adtu50",
              "name": "string",
              "colour": "string",
              "meta": {}
            }
          ]
        },
        "status": "draft"
      },
      "name": "string",
      "slug": "string",
      "description": "string",
      "content": "string",
      "properties": [
        {
          "fid": "cc5lnd2s1s4652adtu50",
          "name": "string",
          "value": "string",
          "type": "text",
          "sort": "string"
        }
      ],
      "meta": {}
    }
  ]
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "detail": "string",
  "trace_id": "string",
  "metadata": {}
}
Edit on GitHub

Node Version Get GET

Get an edit version for a node. The version must belong to the node identified by `node_slug`. Applied versions are immutable historical snapshots and are visible to callers who can read the target node. The draft version is visible only to its author and members with `MANAGE_LIBRARY`.

Node Version Update PATCH

Update the node's single draft checkpoint. This operation is for draft autosave and editing only. It does not change version status and cannot apply a version to the target node. The version must still have draft status and the caller must be the draft author or have `MANAGE_LIBRARY`. Fields omitted from the request are left unchanged on the draft snapshot. Explicit null values clear nullable fields. Properties are a complete desired-state list for the target node properties: when the version is applied, the list replaces the node's existing property set rather than merging with it.