删除文件
... 2026-2-4 大约 1 分钟
# 删除文件
# 接口说明
删除一个文件-包含在线文档、文件夹、共享空间，正常文件被删除会进入回收站，回收站中的文件则会被彻底删除。
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /openapi/drive/v3/files/{fileId} |
| Method | DELETE |
| Content-Type | application/json; charset=utf-8 |
# 请求头部
详见Headers。
# 请求参数
# 路径参数
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fileId | string | 是 | 文件 Id，文件的唯一标识 |
# 请求示例
curl --location --request DELETE 'https://{domain}/openapi/drive/v3/files/DQVBVRUJXYkVWU2pp' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID'
1
2
3
2
3
1
2
3
2
3
# 响应参数
# 响应体
接口请求成功时，若文件在回收站中则会返回文件信息(FileInfo)，被彻底删除则返回空。
# 响应示例
文件在回收站中则会返回文件信息
{
"meta": {
"id": "DQXpDYVZaSXBKYmxX",
"parentId": "trash1022447688093794304",
"name": "ark 测试导出",
"type": "DOC",
"ext": "tencentdoc",
"status": "IN_TRASH",
"url": "https://{domain}/doc/DQXpDYVZaSXBKYmxX",
"icon": "https://{domain}/private_cdn/tim/docs/docs-design-resources/mobile/png@3x/file_doc_64@3x-58ec57f56b.png",
"creator": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"createTime": "1684824432814",
"owner": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"lastModifyingUser": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"modifiedTime": "1684824443000",
"accessTime": "1684824435979",
"isFolder": false,
"isLink": false
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
彻底删除返回空
{}
1
1