.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!

.. _borg_delete:

borg delete
-----------
::

    borg delete <options> TARGET

positional arguments
    TARGET
        archive or repository to delete

optional arguments
    ``-p``, ``--progress``
        | show progress display while deleting a single archive
    ``-s``, ``--stats``
        | print statistics for the deleted archive
    ``-c``, ``--cache-only``
        | delete only the local cache for the given repository
    ``--force``
        | force deletion of corrupted archives
    ``--save-space``
        | work slower, but using less space

`Common options`_
    |

filters
    ``-P``, ``--prefix``
        | only consider archive names starting with this prefix
    ``--sort-by``
        | Comma-separated list of sorting keys; valid keys are: timestamp, name, id; default is: timestamp
    ``--first N``
        | consider first N archives after other filters were applied
    ``--last N``
        | consider last N archives after other filters were applied

Description
~~~~~~~~~~~

This command deletes an archive from the repository or the complete repository.
Disk space is reclaimed accordingly. If you delete the complete repository, the
local cache for it (if any) is also deleted.