minimusdocs
Help center

Backups

Restore an uploaded backup

POST/backups/imports/{import_id}/restore/

manage Delete and money: deletes, credits, servers or panel settings. Scopes

Restores the whole database (whole) or only the chosen components, in the background (202). keep_admins keeps this panel's administrators so you can still sign in; keys also restores the key files the backup holds. Panel operators only.

Path parameters

  • import_idstringrequired

    The backup import's id.

Body

  • wholeboolean

    Default: false

  • componentsstring[]

    One of: "accounts" "lines" "credits" "categories" "bouquets" "streams" "media" "movies" "tv_series" "servers" "access_control" "settings" "viewing_history" "api_calls" "server_metrics" "task_history" "panel_imports" "playlist_editor" "playlist_editor_history" "providers" "watch_folders" "provider_history" "admin_log" "key_files"

  • keysboolean

    Default: false

  • keep_adminsboolean

    Default: true

  • passphrasestring

Response

202 OK

  • idstringrequired
  • filenamestringrequired
  • size_bytesintegerrequired
  • receivedintegerrequired

    Bytes uploaded so far.

  • statusstringrequired
    • uploading - uploading
    • ready - ready
    • restoring - restoring
    • completed - completed
    • failed - failed

    One of: "uploading" "ready" "restoring" "completed" "failed"

  • phasestringrequired
  • messagestringrequired
  • created_bystringrequired
  • created_atstringrequired
  • updated_atstringrequired
  • encryptedboolean
  • archiveobjectrequired

    What the file holds; empty until it is checked.

    • created_atstring
    • scopestring
    • contents_labelstring
    • componentsobject[]

      {key, label, kind} for each part the file holds.

    • filesstring[]
    • databaseobject
    • panel_imagestring
    • adminsobject[]

      {username, is_active} of the administrators in the file.

    • admins_knownboolean
    • accountsobject
    • problemstringcan be null

      Why this file cannot be restored here, if it cannot.

  • optionsobjectrequired

    What the restore was asked to do.

  • outcomeobjectrequired

    What the restore did, once it has finished.

  • chunk_bytesinteger

    Only when the upload starts: send the file in pieces of at most this size.

  • expected_offsetinteger

    Only when a piece was not written: send again from this byte.

  • adminsobject

    Only after a check: the file's administrators against this panel's.

    • knownbooleanrequired

      False for older backups that do not record their administrators.

    • theirsstring[]required
    • minestring[]required
    • only_theirsstring[]required
    • only_minestring[]required
    • differbooleanrequired
    • none_in_backupbooleanrequired

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means