Skip to Main Content

Share your product feedback

Status Future consideration
Categories API
Created by Krysta Boyer
Created on Aug 28, 2026

Position parameter for REST API

What is the challenge?
  • The API has no way to set a page or folder's position within the table of contents tree. parent_id controls nesting, but not order among siblings. Reordering only works by manually dragging in the UI.

What is the impact?
  • Teams automating knowledge setup can't fully script their structure. Anything needing a specific order requires manual cleanup after every API-driven creation.

Describe your idea.
  • Add a position parameter to the update a note endpoint

  • Attach files
  • J Pinetta
    Oct 1, 2026

    The API can't set the order of KB pages and folders. Because of that, we move thousands of pages by hand with drag-and-drop every time we restructure a knowledge base. This is slow and error-prone, and it blocks us from automating KB publishing and migrations.

    What we need is API support for:

    • Setting the position of a page or folder among its siblings

    • Moving a page or folder to a different parent

  • +1