# Delete attachment

### Description

This service allows an authenticated operator to remove a specific file previously attached to a case instance.

***

### Request

#### Restrictions

* Authentication: Requires a successful operator login.
* Authorization: The operator or touchpoint must have the necessary permissions to modify the specified case.

#### Endpoint

```
DELETE https://<server-url>/api/v4/cases/{caseInstanceId}/files/{fileId}
```

#### Path Parameters

| **Parameter**    | **Type** | **Description**                                     |
| ---------------- | -------- | --------------------------------------------------- |
| `caseInstanceId` | Integer  | The unique ID of the case instance.                 |
| `fileId`         | Integer  | The unique ID of the file attachment to be removed. |

#### Parameters

| **Parameter** | **Location**   | **Description**                                                                    |
| ------------- | -------------- | ---------------------------------------------------------------------------------- |
| `touchpoint`  | Query / Header | The identifier for the touchpoint. Use `Thalamus-Touchpoint` for the header.       |
| `token`       | Query / Header | The authentication token for the API session. Use `Thalamus-Token` for the header. |

#### Full URL Example

```
https://<server-url>/api/v4/cases/1/files/3?touchpoint=test&token=...
```

***

### Response

#### ✅ Successful Response: `200 OK`

The file was successfully detached and removed.

Boolean

```
true
```

#### ❌ Unsuccessful Response: `200 OK` (Logical Failure)

The request was processed, but the file could not be removed (e.g., the `fileId` does not belong to the `caseInstanceId`, or the user lacks permissions).

Boolean

```
false
```