Nodes
Sharing

List every node in the space carrying its own live public share

get/api/v1/node-shares

Request

  • Base URL: https://api-docs.busabase.com
  • URL: https://api-docs.busabase.com/api/v1/node-shares
  • Auth: none declared

Response

One row per node that someone explicitly published and that is still live — scope: "public" and unexpired — joined to just enough of the node (name, slug, type, icon) to render and open it. Rows the caller cannot see are omitted (same node-visibility ACL as nodes.list), and the stored share password is never returned, only a hasPassword flag. Deliberately does NOT include nodes that are merely reachable because an ANCESTOR is shared: this is the list of grants a person made, each revocable on its own with nodes.share.disable, which is the same set the workbench sidebar marks with a globe (NodeVO.shared).

nodeIdstring required
namestring required
slugstring required
type'folder' | 'base' | 'skill' | 'drive' | 'airapp' | 'file' | 'doc' | 'form' | 'whiteboard' | 'workflow' | 'html' required
capability'read' | 'submit' required
hasPasswordboolean required
expiresAtstring required
createdAtstring required

Changes

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