delete_page

Propose permanent deletion of a page. Queued for approval by default.

Last updated Apr 22, 2026

`delete_page`

Propose the permanent deletion of a page. Queued for human approval unless the agent has auto-approve enabled.

Deletion is permanent at the API layer — there is no trash/undo flow. Consider proposing an archive-style update (add an archived tag, move to an Archive folder) via update_page when the intent is "hide" rather than "destroy".

Arguments

Name	Type	Required	Description
`page_id`	string	yes	The ID of the page to delete.

Returns

Auto-approved

{
  "content": [{ "type": "text", "text": "Page deleted: note_xyz789." }]
}

Awaiting approval

{
  "content": [
    {
      "type": "text",
      "text": "Delete proposal submitted — awaiting approval in Plainwork. Action ID: act_abc123."
    }
  ]
}

Example

{
  "tool": "delete_page",
  "arguments": {
    "page_id": "note_xyz789"
  }
}