## Delete a file

**delete** `/v5/files/{file_id}`

Delete a file by id, removing its database record.

This is a hard delete: the file's row is removed from the database, not
soft-archived. The underlying stored object is deleted only when no other
file record still references the same stored content (identical checksum and
MIME type); when another record shares the blob, the blob is retained. If the
id refers to an incomplete multipart upload placeholder, its staged parts are
aborted instead. Returns a confirmation carrying the deleted file's id.

### Path Parameters

- `file_id: string`

### Header Parameters

- `"x-project-id": optional string`

### Returns

- `id: string`

- `deleted: boolean`

- `object: optional "file"`

  - `"file"`

### Example

```http
curl https://api.egp.scale.com/v5/files/$FILE_ID \
    -X DELETE \
    -H "x-api-key: $SGP_API_KEY"
```

#### Response

```json
{
  "id": "id",
  "deleted": true,
  "object": "file"
}
```