Nodes
Change Requests

Create Node tree change request

post/api/v1/nodes/change-requests

Request

  • Base URL: https://api-docs.busabase.com
  • URL: https://api-docs.busabase.com/api/v1/nodes/change-requests
  • Auth: none declared

Request body

messagestring

Explanation shown to the human reviewer. Write a conventional-commit style subject — imperative verb + what + why, e.g. "Reorganize marketing docs under a Campaigns folder".

submittedBystring
autoMergeboolean

Whether to approve and merge this structural node change immediately. Omitted defaults to merging immediately if the actor has write access on every target node, otherwise falling back to a pending Change Request; pass explicit false to force review even with write access.

Response

Created change request for folder or node tree changes.

idstring required
baseIdstring required
targetType'base' | 'node' required
nodeIdstring required
status'in_review' | 'changes_requested' | 'approved' | 'rejected' | 'merged' | 'abandoned' | 'conflict' required
submittedBystring required
sourceMetaobject required
reviewPolicySnapshotobject required
mergeSummaryobject required

Filled in when the change request merges. slugChanges (present only when non-empty) lists items a restore brought back under a new slug because another item took the old one while they were in the Trash: { nodeId, nodeType, name, fromSlug, toSlug }. Read the new slug from here instead of assuming the old one.

rejectedReasonstring required
reviewedAtstring required
mergedAtstring required
createdAtstring required
updatedAtstring required
operationCountnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.