Overview
This API is used to delete a specified batch file. After successful deletion, the returned file object will contain the deleted=true flag. Currently, this API is supported only by Alibaba Cloud's Qwen series of models.
API details
Constraints
- The caller must have an API Key. For more information, see Manage AI API Keys.
Request path
DELETE {BASE_URL}/api/v1/files/{file_id}
Request header
Name |
Required |
Example value |
Description |
|---|---|---|---|
| Authorization | Yes | Bearer {token} | Authentication information |
| Content-Type | No | application/json | Request body format |
Request parameters
Path
Name |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| file_id | string | Yes | file-abc123 | ID of the batch file to be deleted |
Query
None
Body
None
Response
Response parameters
Name |
Type |
Description |
|---|---|---|
| success | boolean | Whether the request was successful |
| code | string | Response code |
| message | string | Response information |
| data | object | Business response data |
data
The deleted file object is returned. Its specific field structure is unknown.
Request example
curl --request DELETE '{BASE_URL}/api/v1/files/file-abc123' \
--header 'Authorization: Bearer {token}'
Response example
Successful response (200)
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"id": "file-abc123",
"object": "file",
"deleted": true
}
}
Unauthorized response (401)
{
"success": false,
"code": "401",
"message": "Unauthorized"
}
File not found response (404)
{
"success": false,
"code": "404",
"message": "File not found"
}