Deleting Pages and Directories#

Use delete() to move pages and directories into the notebook’s API Deleted Items folder. delete() renames the item and moves it to API Deleted Items; it does not permanently erase the item.

How Deletion Works#

When you delete a page or directory:

  1. The item is renamed with a deletion timestamp.

  2. The item is moved to API Deleted Items under the notebook root.

Delete a Page#

page = notebook.traverse("My Folder/Page to Delete")
page.delete()

After deletion, the page is renamed to something like:

Page to Delete - Deleted at 2024-01-15 14:30:22

Delete a Directory#

directory = notebook.traverse("Old Project")
directory.delete()

Deleting a directory moves the directory itself — including all of its pages and subdirectories — into API Deleted Items.

Recover Deleted Items#

To recover a deleted item, navigate to API Deleted Items and move it back:

from labapi import Index

deleted_items = notebook[Index.Name:"API Deleted Items"][0]
deleted_page = deleted_items["Page to Delete - Deleted at 2024-01-15 14:30:22"]

original_folder = notebook.traverse("My Folder")
deleted_page.move_to(original_folder)
deleted_page.name = "Page to Delete"

Entry Deletion#

Note

Individual entries such as text entries, attachments, and headers cannot be deleted through the API.