Delete Space

DELETE /api/v1/spaces/{space}

SpaceService · SpaceService_DeleteSpace

基于协议生成的参考。授权与实例策略仍然生效。结构描述继承自 MIT 许可的应用接口定义；本站不会向真实服务执行示例。

访问权限

需要有效成员的空间 ADMIN 角色；不是空间管理员的实例管理员不能执行这些管理操作。

删除空间内全部笔记

永久删除空间、成员资格及当前归属于该空间的每条笔记和所属附件，涉及所有作者的笔记，不是归档或移回个人空间。关系边不会使删除扩展至空间外笔记。调用前应导出或移动需要保留的内容；存储清理可能在删除事务提交后失败。

成功响应

此操作没有资源对象需要返回。Rust REST 传输将 protobuf Empty 序列化为 HTTP 200 与 JSON {}。生成接口定义中的成功结构为空是有意行为，不表示遗漏了请求说明。

请求

DeleteSpace permanently deletes a space and every memo currently placed in it. It never follows memo relations to other memos.

DELETE/api/v1/spaces/{space}

参数

名称 / 位置	类型 / 是否必需	描述
`space` path	string 必需	The space id.

请求体

未声明请求体。

响应

200 · OK

default · Default error response

application/json · Status

完整操作定义

下方保留全部已声明约束、媒体类型和响应细节。结构引用链接到完整定义。

展开 JSON 定义

{
  "tags": [
    "SpaceService"
  ],
  "description": "DeleteSpace permanently deletes a space and every memo currently placed\n in it. It never follows memo relations to other memos.",
  "operationId": "SpaceService_DeleteSpace",
  "parameters": [
    {
      "name": "space",
      "in": "path",
      "description": "The space id.",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {}
    },
    "default": {
      "description": "Default error response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Status"
          }
        }
      }
    }
  }
}