Skip to main content

Backups

ZIP backups of the organization, with every workspace. download fetches the file; restore create restores a backup into the calling workspace — it is destructive and asynchronous — and cancel stops a restore in progress.

CommandHTTPDescription
backups listGET /v1/backupsList backups
backups createPOST /v1/backupsRequest backup
backups getGET /v1/backups/{id}Get backup
backups deleteDELETE /v1/backups/{id}Delete backup
backups cancelPOST /v1/backups/{id}/cancelCancel restore
backups downloadGET /v1/backups/{id}/downloadDownload backup
backups restore createPOST /v1/backups/restoreRestore backup

Examples​

--params carries query, path and header parameters (id, page, filters, X-Workspace-Id); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# List backups
kobana dashboards backups list \
--fields "id,type,status,file_size_bytes,created_at"

# Request backup
kobana dashboards backups create

# Download backup
kobana dashboards backups download \
--params '{"id": "BACKUP_ID"}' \
--output backup.zip

# Restore backup
kobana dashboards backups restore create \
--json '{"backup_id": "BACKUP_ID"}' \
--dry-run

Next steps​