Storyden
Nodes

Node Draft List

List a page of draft versions across nodes visible to the caller. This endpoint is designed for moderation and queue screens where you need to review pending draft proposals across nodes. Each draft includes a reference to its target node for context. Drafts are visible based on the caller's permissions: - Draft authors can see their own drafts - Members with `MANAGE_LIBRARY` can see all drafts - Unauthenticated requests receive 401 Unauthorized Results are ordered by `updated_at` descending so recently updated drafts appear first. Use the `page` parameter and response pagination metadata to continue through the results.

GET/nodes/drafts

List a page of draft versions across nodes visible to the caller.

This endpoint is designed for moderation and queue screens where you need to review pending draft proposals across nodes. Each draft includes a reference to its target node for context.

Drafts are visible based on the caller's permissions:

  • Draft authors can see their own drafts
  • Members with MANAGE_LIBRARY can see all drafts
  • Unauthenticated requests receive 401 Unauthorized

Results are ordered by updated_at descending so recently updated drafts appear first. Use the page parameter and response pagination metadata to continue through the results.

Authorization

storyden-session<token>

In: cookie

Query Parameters

page?string

Pagination query parameters.

Response Body

application/json

application/json

curl -X GET "https://example.com/nodes/drafts"
{  "page_size": 0,  "results": 0,  "total_pages": 0,  "current_page": 0,  "next_page": 0,  "drafts": [    {      "id": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "node_id": "string",      "author": {        "id": "string",        "joined": "2019-08-24T14:15:22Z",        "suspended": "2019-08-24T14:15:22Z",        "handle": "string",        "name": "string",        "signature": "string",        "roles": [          {            "badge": true,            "default": true,            "id": "string",            "name": "string",            "colour": "string",            "meta": {}          }        ]      },      "status": "draft",      "previous": {        "id": "string",        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z",        "author": {          "id": "string",          "joined": "2019-08-24T14:15:22Z",          "suspended": "2019-08-24T14:15:22Z",          "handle": "string",          "name": "string",          "signature": "string",          "roles": [            {              "badge": true,              "default": true,              "id": "string",              "name": "string",              "colour": "string",              "meta": {}            }          ]        },        "status": "draft"      },      "name": "string",      "slug": "string",      "description": "string",      "content": "string",      "properties": [        {          "fid": "string",          "name": "string",          "value": "string",          "type": "text",          "sort": "string"        }      ],      "meta": {},      "node": {        "id": "string",        "createdAt": "2019-08-24T14:15:22Z",        "updatedAt": "2019-08-24T14:15:22Z",        "deletedAt": "2019-08-24T14:15:22Z",        "misc": {},        "name": "string",        "slug": "string",        "current_version_id": "string",        "assets": [          {            "id": "string",            "filename": "string",            "path": "string",            "mime_type": "string",            "width": 0,            "height": 0,            "parent": {}          }        ],        "link": {          "id": "string",          "createdAt": "2019-08-24T14:15:22Z",          "updatedAt": "2019-08-24T14:15:22Z",          "deletedAt": "2019-08-24T14:15:22Z",          "misc": {},          "url": "string",          "slug": "string",          "domain": "string",          "title": "string",          "description": "string",          "favicon_image": {            "id": "string",            "filename": "string",            "path": "string",            "mime_type": "string",            "width": 0,            "height": 0,            "parent": {}          },          "primary_image": {            "id": "string",            "filename": "string",            "path": "string",            "mime_type": "string",            "width": 0,            "height": 0,            "parent": {}          }        },        "description": "string",        "primary_image": {          "id": "string",          "filename": "string",          "path": "string",          "mime_type": "string",          "width": 0,          "height": 0,          "parent": {}        },        "content": "string",        "owner": {          "id": "string",          "joined": "2019-08-24T14:15:22Z",          "suspended": "2019-08-24T14:15:22Z",          "handle": "string",          "name": "string",          "signature": "string",          "roles": [            {              "badge": true,              "default": true,              "id": "string",              "name": "string",              "colour": "string",              "meta": {}            }          ]        },        "parent": {},        "hide_child_tree": true,        "tags": [          {            "name": "string",            "colour": "string",            "item_count": 0          }        ],        "visibility": "draft",        "relevance_score": 0,        "meta": {}      }    }  ]}
Edit on GitHub

Node Delete DELETE

Delete a node and move its direct children to the root, or to the parent specified by `target_node`.

Node Generate Content POST

Generate proposed content for the specified node. Will not actually mutate the specified node, instead will return a proposal based on the output from a language model call.