Deleting a backup

Should you wish to delete a backup, for disk space’s sake, or just to reduce clutter.

Note: We only allow one backup to be deleted per call. This is both for simplicity and also to try and reduce mistakes. Deleted backups are permanent and cannot be recovered.

Example Call

All that is required is the relevant ID. In this example we will delete backup 4 - as created here.

curl -s -X POST  --header "Authorization: ${TC_OIDC_TOKEN}" --location 'https://telicent.core.domain/api/sparql/backups/delete/4'

Response

As illustrated below, the response simply gives the date, the ID deleted and whether the operation was successful.

{
  "delete-id" : "/4",
  "date" : "2025-06-27_11-35-45",
  "delete" : {
    "delete-id" : "/4",
    "date" : "2025-06-27_11-35-45",
    "deletePath" : "/fuseki/backups//4",
    "success" : true
  }
}

Error Response

By comparison, if we passed an unsuitable ID - say 19; the response would be:

{
  "delete-id" : "/19",
  "date" : "2025-06-27_11-37-37",
  "delete" : {
    "delete-id" : "/19",
    "date" : "2025-06-27_11-37-37",
    "deletePath" : "/fuseki/backups//19",
    "reason" : "Backup path unsuitable: /fuseki/backups//19",
    "success" : false
  }
}