# Delete a file

Soft-deletes the file record and best-effort removes the object from storage. Idempotent.

## DELETE /v1/files/{id}

> Delete a file

Soft-deletes the file record and best-effort removes the object from storage. Idempotent.

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **id** `string` **(required)**  
  File ID (with `file-` prefix)

### Response

- **id** `string`  
  
- **object** `string`  
  
- **deleted** `boolean`  
  

### Error Codes

- `401`: 
- `404`: File not found or not owned by the caller