# Delete File

**Endpoint**

`DELETE/v2/storage/file/{id}`

**Link**

{% embed url="<https://stagep.tst-apidmndelss.com/openapi/v2.html#/operations/Storage_Delete>" %}

### **Request**

#### **Path Parameters**

| Parameter | Type     | Description                   | Required | Example        |
| --------- | -------- | ----------------------------- | -------- | -------------- |
| **`id`**  | `string` | **File unique ID** to delete. | Yes      | `"file_78901"` |

#### **Query Parameters**

| Parameter        | Type     | Description                                           | Required | Example        |
| ---------------- | -------- | ----------------------------------------------------- | -------- | -------------- |
| **`customerId`** | `string` | **Customer ID** for additional authorization context. | No       | `"cust_12345"` |

#### **Headers**

| Key             | Value              | Required |
| --------------- | ------------------ | -------- |
| `Authorization` | `123`              | Yes      |
| `Accept`        | `application/json` | Yes      |

***

### **Response (200 OK)**

Returns a success status and message confirming the file deletion.

#### **Response Fields**

| Field         | Type      | Description                   | Example                       |
| ------------- | --------- | ----------------------------- | ----------------------------- |
| **`success`** | `boolean` | **Deletion status**.          | `true`                        |
| **`message`** | `string`  | **Operation result message**. | `"File deleted successfully"` |

***

### **Examples**

#### **Request (Delete File)**

bash

```
curl -X DELETE 'https://stagep.tst-apidmndelss.com/v2/storage/file/file_78901' \
  -H 'Authorization: 123' \
  -H 'Accept: application/json'
```

#### **Response**

json

```
{
  "success": true,
  "message": "File deleted successfully"
}
```

#### **Request (Delete File with Customer Context)**

bash

```
curl -X DELETE 'https://stagep.tst-apidmndelss.com/v2/storage/file/file_78902?customerId=cust_12345' \
  -H 'Authorization: 123' \
  -H 'Accept: application/json'
```

#### **Response**

json

```
{
  "success": true,
  "message": "File file_78902 deleted for customer cust_12345"
}
```

#### **Request (Delete Non-Existent File)**

bash

```
curl -X DELETE 'https://stagep.tst-apidmndelss.com/v2/storage/file/file_99999' \
  -H 'Authorization: 123' \
  -H 'Accept: application/json'
```

#### **Response (Error)**

json

```
{
  "success": false,
  "message": "File not found: file_99999"
}
```

***

### **Error Responses**

1. **File Not Found**:

   json

   ```
   {
     "success": false,
     "message": "File not found: file_99999"
   }
   ```
2. **File Locked**:

   json

   ```
   {
     "success": false, 
     "message": "File is locked and cannot be deleted"
   }
   ```
3. **Access Denied**:

   json

   ```
   {
     "success": false,
     "message": "Access denied to file: file_78901"
   }
   ```
4. **Unauthorized**:

   json

   ```
   {
     "success": false,
     "message": "Unauthorized"
   }
   ```
5. **Customer Mismatch**:

   json

   ```
   {
     "success": false,
     "message": "File does not belong to specified customer"
   }
   ```

***

### **Notes**

* **Soft Delete**: Files are typically marked as deleted rather than permanently removed
* **Audit Trail**: Deletion is logged for compliance and tracking purposes
* **Access Control**: Files can only be deleted by authorized users with proper permissions
* **Locked Files**: Files with `isLock=true` cannot be deleted
* **Customer Context**: Providing `customerId` adds an additional security layer
* **Idempotent**: Deleting an already deleted file returns success

**Common Use Cases**:

* Removing outdated customer documents
* Cleaning up temporary uploads
* Compliance with data retention policies
* User-initiated file management
* Administrative file cleanup

**Security Considerations**:

* Files are only deletable by users with appropriate permissions
* Customer context validation prevents cross-customer file access
* Locked files require administrative override
* Deletion operations are logged for audit purposes


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.delos.financial/files/delete-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.