Delete Knowledge Base Page
Tool ID: kb_delete
Summary
Permanently deletes a knowledge base page by path or id. You must confirm explicitly.
When to use it
- Remove obsolete content — After confirming the page is no longer needed.
- Clean up mistakes — After Add created the wrong page.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes (client tier — not on the free/public set) |
| Extra service credentials | No |
Parameters
| Parameter | Required? | Description |
|---|---|---|
path |
One of path or id | Document path. |
id |
One of path or id | Document id. |
confirm |
Yes | Must be true to delete. |
What you get back
deleted: true and a snapshot of the removed document. If the page had children, those pages remain but their parent link is cleared (orphaned_children count).
Without confirm=true, the tool refuses and returns a message.
Example prompts
Delete the knowledge base page at path draft/scratch. Confirm yes.
Remove KB document id 12 after I confirm.
Tips
- Deletion is permanent — prefer Update with
status: archivedif you might need the content later. - Child pages are not deleted automatically; they become top-level.