Signature
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.