Skip to main content

Add a backup destination

POST 
/backup/destinations

Required role: admin. Only an account or token with the admin role can call this operation.

Example request
curl --request POST \
  --header "Authorization: Bearer $HOSERVA_TOKEN" \
  --header "Content-Type: application/json" \
  --data @body.json \
  "https://$HOSERVA_HOST:8008/api/v1/backup/destinations"

A remote destination (smb, s3, sftp, webdav, rclone) is written through rclone and is always encrypted. It is refused with 400 backup_passphrase_required while no backup passphrase is set, and with 424 rclone_missing — whose message carries the install command — when rclone is not installed. Credentials in secrets are sealed under the machine key before they reach the database. Local destinations work without rclone.

Request​

Responses​

The new destination.