文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>智能媒资托管>业务级 API 文档>租户空间操作接口>删除租户空间

删除租户空间

最近更新时间：2026-04-03 18:16:52

我的收藏

本页目录：

功能描述

用于删除租户空间。
说明：
需要 admin 或 delete_space 权限，有关权限详情请参见 生成访问令牌接口。

请求

请求示例

DELETE /api/v1/space/`{LibraryId}`/`{SpaceId}`?access_token=`{AccessToken}`&user_id=`{UserId}`&force=`{Force}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库
String
是
SpaceId
空间 ID，获取请参见 创建租户空间
String
必须指定该参数且不支持单租户模式
AccessToken
访问令牌，获取请参见 生成访问令牌
String
是
UserId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参见 生成访问令牌接口
String
否
Force
是否强制删除：
0：非强制删除，不允许删除非空的 space
1：强制删除，不判断 space 是否为空
可选参数，默认为0。
Integer
否

请求体

该请求无请求体。

响应

响应码

删除成功，返回 HTTP 204 No Content。

响应体

该请求无响应体。

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

实际案例

案例一：删除 space

请求
DELETE /api/v1/space/smhxxx/spacexxx?access_token=*** HTTP/1.1
Host: smhxxx.api.tencentsmh.cn
User-Agent: curl/8.5.0
Accept: */*

若 space 为空，响应如下：
HTTP/1.1 204 No Content
Date: Wed, 12 Nov 2025 02:10:27 GMT
Server: nginx/1.29.0
X-Request-Id: 873a29bbbc19df14959fc1cc73a8a80b

若 space 非空，响应如下：
HTTP/1.1 409 Conflict
Date: Wed, 12 Nov 2025 02:10:27 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 162
Server: nginx/1.29.0
X-Request-Id: c8cc7046d6ecb4a1c0e601c9f9908476

{
    "status":409,
    "code":"SpaceNotEmpty",
    "message":"Space not empty, cannot be deleted.",
    "requestId":"c8cc7046d6ecb4a1c0e601c9f9908476"
}

案例二：强制删除非空 space

请求
DELETE /api/v1/space/smhxxx/spacexxx?access_token=***&force=1 HTTP/1.1
Host: smhxxx.api.tencentsmh.cn
User-Agent: curl/8.5.0
Accept: */*

响应
HTTP/1.1 204 No Content
Date: Wed, 12 Nov 2025 02:10:27 GMT
Server: nginx/1.29.0
X-Request-Id: 873a29bbbc19df14959fc1cc73a8a80b

中国站