V2
Delete Page
Move a page to trash and return its soft-delete result.
Delete Page
When to use
Use this endpoint to move a page to trash without permanently deleting it.
Note: Delete endpoints are intentionally omitted from the machine-readable OpenAPI specification and are not projected to MCP or CLI. This page documents the HTTP endpoint.
Endpoint
| Item | Value |
|---|---|
| Method | DELETE |
| Path | /v2/pages/:page_id |
| Request body | None |
| Response | Soft-deleted page result |
| Scope | pages.write |
page_id must be the UUID of a page the credential can write.
Response
{
"object": "page",
"id": "22222222-2222-4222-8222-222222222222",
"in_trash": true
}
Behavior
- Deletion is soft: only the target page root is archived; no data is physically deleted.
- Child pages and blocks become unavailable with the root, but are not individually rewritten as deleted. Restoring the root restores the complete subtree.
- V2 API does not expose permanent page deletion.
- Repeating the request for a page that is already in trash still succeeds.
Errors
401 unauthorized: token is invalid or expired.403 forbidden: missingpages.writeor no write access to the page.404 not_found: page does not exist.