## Signature

```text
delete_file({ file_id })
```

Supply the UUID returned by `get_files` or `upload_file`. Deletion is permanent: download/reference links stop working, including the file displayed in past run output. Agents must have the user's authority to delete that file.

An active run using the file returns `file_in_use`; wait for it to finish. A completed deletion releases its storage only after the stored object is removed. If storage is temporarily unavailable, the file becomes unavailable and cleanup retries; its quota remains occupied until the bytes are removed.

Repeating the same deletion is safe, and a missing file returns an idempotent success. No wallet charge or provider execution occurs. Workspace file access is required, and no other workspace's file can be deleted.

CLI: `scrollport delete_file <file-id>`. HTTP: `DELETE /v1/files/:id`.