Delete File
Permanently deletes a file from Cloudflare R2 storage, removes all database records, translations, relationships with products, and clears CDN cache. Triggers product update events for all items that previously used this file.
/api/v1/{team_slug}/{app_slug}/files/{file_id}- API
- Management
- OpenAPI
- management-api
- Updated
- Apr 26, 2026
management-api:DELETE:/api/v1/{team_slug}/{app_slug}/files/{file_id}
Permanently deletes a file from Cloudflare R2 storage, removes all database records, translations, relationships with products, and clears CDN cache. Triggers product update events for all items that previously used this file.
API ownership
- API family: Management API
- Best for: Trusted back-office workflows that create, update, organize, or delete merchant-owned data.
- Do not use from: Browser-only storefront code or public clients.
- Guide route: /apis/management/latest
The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.
Operation
- Method:
DELETE - Path:
/api/v1/\{team_slug\}/\{app_slug\}/files/\{file_id\} - Summary: Delete File
- Description: Permanently deletes a file from Cloudflare R2 storage, removes all database records, translations, relationships with products, and clears CDN cache. Triggers product update events for all items that previously used this file.
- OpenAPI contract: management-api
- Operation ID: Not documented in the OpenAPI contract.
Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| app_slug | path | Yes | string | App slug |
| team_slug | path | Yes | string | Team slug |
| file_id | path | Yes | string | File ID |
Request body
Not documented in the OpenAPI contract.
Responses
| Status | Description | Content |
|---|---|---|
| 200 | File deleted successfully | application/json (object) |
| 401 | Unauthorized access | application/json (object) |
| 404 | File not found | application/json (object) |
| 500 | Internal server error | application/json (object) |
200 - object
File Response
| Property | Type | Required | Details |
|---|---|---|---|
data | string | No | - |
details | string[] | No | Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes |
success | boolean | No | - |
Generated example (synthetic):
{
"data": "string",
"details": [
"string"
],
"success": false
}401 - object
Error Message
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
message | string | No | - |
success | boolean | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"message": "string",
"success": false
}404 - object
Error Message
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
message | string | No | - |
success | boolean | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"message": "string",
"success": false
}500 - object
Error Message
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
message | string | No | - |
success | boolean | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"message": "string",
"success": false
}Contract identity
Use these fields to confirm you are implementing the intended endpoint contract.
- API family: Management API
- Method:
DELETE - Path:
/api/v1/\{team_slug\}/\{app_slug\}/files/\{file_id\} - Operation ID: Not documented in the OpenAPI contract.
- OpenAPI tag: Files
- OpenAPI summary: Delete File