Storyden
Nodes

Node Version Draft Update

Update the node's single working draft checkpoint. This is a stable alias for patching the draft version of a node without first listing versions or knowing the draft version identifier. The node must already have a draft visible to the caller. This operation does not create a draft and does not apply the draft to the target node. 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.

PATCH/nodes/{node_slug}/versions/draft

Update the node's single working draft checkpoint.

This is a stable alias for patching the draft version of a node without first listing versions or knowing the draft version identifier. The node must already have a draft visible to the caller. This operation does not create a draft and does not apply the draft to the target node.

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.

Authorization

storyden-session<token>

In: cookie

Path Parameters

node_slug*string

Unique node Slug.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Updates to a draft checkpoint snapshot. This does not change version status. Omitted fields keep the current draft value. Nullable fields can be set to null to clear them. Properties are replace-all and are not merged with existing values when the version is applied.

Response Body

application/json

application/json

curl -X PATCH "https://example.com/nodes/cc5lnd2s1s4652adtu50/versions/draft" \  -H "Content-Type: application/json" \  -d '{}'
{
  "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
Empty
Empty
{
  "type": "string",
  "title": "string",
  "detail": "string",
  "trace_id": "string",
  "metadata": {}
}
Edit on GitHub

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`.

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`.