V2
删除块
将单个 block 软删除，并返回回收站状态。
删除块
适用场景
当你要把单个 block 移入回收站，而不是永久删除时使用这个接口。它适合需要保留恢复能力的内容管理场景。
接口信息
| 项目 | 内容 |
|---|---|
| 方法 | DELETE |
| 路径 | /v2/blocks/:block_id |
| 请求体 | 无 |
| 返回 | block 删除结果 |
| Scope | blocks.write |
权限要求
需要 blocks.write。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
block_id | string | 是 | block ID。 |
响应结果
{
"object": "block",
"id": "88888888-8888-4888-8888-888888888888",
"in_trash": true
}行为说明或限制
- 这是软删除，不会物理删除数据。
- 目标 block 的子块也会一并进入回收站。
- 删除后会从父 block 的直接子块列表中移除。
- 如果 block 已在回收站中，重复删除仍会返回成功结果。
错误提示
401 unauthorized：token 无效或已过期。403 forbidden：缺少blocks.write或无权访问该 block。404 not_found：block 不存在。