Developer API
V2

删除页面

将页面移入回收站,并返回软删除结果。

DELETE /v2/pages/:page_id

删除页面

适用场景

当你要把页面移入回收站,而不是永久删除时,使用这个接口。它适合需要保留恢复能力的场景。

接口信息

项目内容
方法DELETE
路径/v2/pages/:page_id
请求体
返回page 删除结果
Scopepages.write

权限要求

需要 pages.write

请求参数

参数类型必填说明
page_idstring页面 ID。

响应结果

{
  "object": "page",
  "id": "22222222-2222-4222-8222-222222222222",
  "in_trash": true
}

行为说明或限制

  • 这是软删除,不会物理删除数据。
  • 页面下的子页面和子块也会一并进入回收站。
  • 如果页面已经在回收站中,重复删除仍会返回成功结果。

错误提示

  • 401 unauthorized:token 无效或已过期。
  • 403 forbidden:缺少 pages.write 或无权访问该页面。
  • 404 not_found:页面不存在。

相关文档

前置阅读

下一步

相关参考