Login/Register
Installatron Server
API Documentation
⌂

View Backup

GET /backups/{id}

View an backup's meta data.

Parameters


API

/backups/{id}
API endpoint.

{id} is internal ID of the backup to view.
GET
Method.

Optional parameters

user
string
The Installatron Server user the task is to be performed on or for.

default is the owner of the backup identified by {id} in the API request

Response


Response

status
int
HTTP status code describing the result of the request.

200
for Success.
All other numbers represent errors which are described in the errcode output below.
result
boolean
true
= Success.
false
= Failure.
errcode
string
status code 403
invalid_api_key
The server's Installatron Server Key is invalid.
invalid_argument_user
User specified is not authorized to access this data.
status code 404
backup_not_found
The backup archive is not found in its backup location.
user_not_found
The specified user could not be found in the Installatron Server database.
errfield
enum
If the cause of an error was an incorrect field value then this will show the ID of the field.
(eg.
login
,
passwd
,
email
)
message
string
Message describing the result of the request. Do not rely on this to determine the success or failure of the request.
data


↳
backup_filename
string
Backup filename.
(eg.
app_mydomain-com_My-blog_2021-01-01_12-00-00.tar.gz
)
↳
backup_install
string
Internal IP of the app that was backed up.
↳
backup_location
string
Location of the backup.
(eg
local
for the local account, or a URI for an offsite location)
↳
backup_note
string
Optional note about this backup.
↳
backup_time
integer
Date and time when the backup was created (as a Unix timestamp).
(eg.
1234567890
)
↳
id
string
Internal ID for this install.
(eg.
1234567890abcdefghij12345
)
↳
agent
string
Version of Installatron that installed or imported this install.
(eg.
5.0.0
)
↳
application
string
Type of application this is, referenced by its internal application ID.
(eg.
wordpress
,
drupal
,
magento
)

See Apps Table for a complete list of installer IDs.
↳
autobk
enum
The automatic backup configuration.
  • none
    = Auto-backups are disabled.
  • schedule
    = Use the admin-defined backup schedule referenced by the autobk_schedule parameter.
  • custom
    = Use the backup schedule defined by the combined autobk_daily, autobk_weekly, and autobk_monthly parameters.


default is
none
↳
autobk_schedule
string
(Only when autobk is
schedule
)
Internal ID of backup schedule that will be used for this app's backing up.
(eg.
1234567890abcdefghij1234567890ab
)

Schedules are created by an admin or reseller account in Installatron administration > Schedules and a schedule ID can be found by either editing the schedule from there (the ID is the first value displayed on the edit page), or by using the GET /set/backup_schedules API.

default is no value
↳
autoup
enum
Automatic update configuration.
  • none
    = Never update.
  • all
    = Always update.
    • minor
    = Update to new minor versions.


default is
minor
↳
autoup_backup
enum
Automatically create a backup and automatically restore the backup if the update fails.
  • none
    = Never backup.
  • all
    = Always backup.


default is
all
↳
autoup_plugins
enum
(WordPress only) Automatic plugin update configuration.
  • none
    = Never update.
  • all
    = Always update.
  • custom
    = Per-plugin control over what will and won't be auto-updated.


default is
all
↳
autoup_themes
enum
(WordPress only) Automatic themes update configuration.
  • none
    = Never update.
  • all
    = Always update.
  • custom
    = Per-theme control over what will and won't be auto-updated.


default is
all
↳
bkloc
string
Location of new backups for this app.
  • local
    for the user's account
  • Or the internal ID of a remote backup location. (eg.
    1234567890abcdefghij12345
    )
↳
cache_files
(internal use only)
↳
cache_numbackups
(internal use only)
↳
cache_preview
(internal use only)
↳
cache_table
(internal use only)
↳
cache_time
(internal use only)
↳
db_host
string
IP address or hostname of the database server used by this app.
(eg.
localhost
,
127.0.0.1
, or a remote IP/hostname)
↳
db_type
enum
Type of database used by this app.
(eg.
mysql
,
pgsql
)
↳
db_name
string
Name of the database used by this app.
↳
db_user
string
Name of the database-user used by this app.
↳
db_pass
string
Name of the database-user's password used by this app.
↳
db_prefix
string
Name of the database table prefix used by the tables of this app.
(eg.
wp_
,
dw8q_
)
↳
login
string
A custom field value of this installer, in this case the administrative user's username.
(eg.
admin
)
↳
email
string
An example custom field value of this installer, in this case the administrative user's email address.
(eg.
username@mydomain.com
)
↳
language
enum
Language used by this install.
(eg.
en
,
no
)

See the GET /browser/{id} API to find a full list of languages supported by this version of this application.
↳
sitetitle
string
A custom field value of this website, in this case the website's title.
(eg.
My Family Blog
)
↳
sitetagline
string
A custom field value of this website, in this case the website's tagline.
(eg.
The personal blog of the family Smith.
)
↳
limitloginattempts
boolean
A custom field value of this website, in this case
yes
indicates this optional (WordPress only) plugin is enabled.
↳
twofactor
boolean
A custom field value of this website, in this case
yes
indicates this optional (WordPress only) plugin is enabled.
↳
exclude_files
array of strings
Array of files and folders the user has selected to be excluded from backups and clones of this app.

eg.
"exclude_files": [
  "wp-content/cache"
],
↳
files
array of strings
Array of files and folders that Installatron knows to be associated with this app.

eg.
"tables": [
  "index.php",
  "license.txt",
  ".htaccess",
  ".maintenance",
  "readme.html",
  "wp-activate.php",
  "wp-admin",
  "wp-app.php",
  "wp-blog-header.php",
  "wp-comments-post.php",
  "wp-config.php",
  "wp-config-local.php",
  "wp-config-sample.php",
  "wp-content",
  "wp-cron.php",
  "wp-includes",
  "wp-links-opml.php",
  "wp-load.php",
  "wp-login.php",
  "wp-mail.php",
  "wp-settings.php",
  "wp-signup.php",
  "wp-trackback.php",
  "xmlrpc.php"
],
↳
incomplete
boolean
Indicates when the application is incomplete/broken.
(eg.
false
for the application is complete,
true
for an install, migration, or clone failed to create this application successfully*

*In this case we recommend that you uninstall this broken install and try the task again, or restore a backup)
↳
link_admin
string
Path, relative to the install's main URL, to the app's administrative backend.
(eg.
wp-admin
)
↳
notification
array of strings
Array of email notifications that the owner of this app will receive. An empty array means no notifications.

Available notifications:
  • backup
  • backup_error
  • clone
  • clone_error
  • install
  • install_error
  • plugin_update
  • plugin_update_available
  • plugin_update_error
  • restore
  • restore_error
  • sync
  • sync_error
  • template
  • template_error
  • update
  • update_available
  • update_error
(eg.
["update_available","update","update_error"]
)
(eg.
[]
for no notifications)

default is all notification types enabled
↳
parent
string
Internal ID of the application this app was staged from.
(eg.
1234567890abcdefghij12345
)

default is empty
↳
path
string
Location of this install's files.

(eg.
/home/username/public_html/blog
)
(eg.
/var/www/vhosts/mydomain.com
)
(eg.
c:\inetpub\vhosts\mydomain.com
)
↳
plugins
array of structures
(WordPress only) Array of information about the plugins used by this application and whether auto-updating is enabled.

eg.
"plugins": [
  {
    "id": "akismet",
    "version": "5.3.6",
    "activated": false,
    "autoup": "all"
  },
  {
    "id": "limit-login-attempts-reloaded",
    "version": "2.26.18",
    "activated": true,
    "autoup": "all"
  }
],


See the GET /installs/plugins API for more information.
↳
stage
string
Internal ID of the app that will be selected as the default stage when then app is synced.
(eg.
1234567890abcdefghij12345
)

default is empty
↳
tables
array of strings
Array of all database tables Installatron knows to be associated with this app.

eg.
"tables": [
  "wp_commentmeta",
  "wp_comments",
  "wp_links",
  "wp_options",
  "wp_postmeta",
  "wp_posts",
  "wp_term_relationships",
  "wp_term_taxonomy",
  "wp_termmeta",
  "wp_terms",
  "wp_usermeta",
  "wp_users"
],
↳
themes
array structure
(WordPress only) Array of information about the themes used by this application and whether auto-updating is enabled.

eg.
"themes": [
  {
    "id": "twentytwentythree",
    "version": "1.6",
    "active": false,
    "autoup": "all"
  },
  {
    "id": "twentytwentyfive",
    "version": "1.1",
    "active": false,
    "autoup": "all"
  }
],


See the GET /installs/themes API for more information.
↳
time_created
integer
Date and time when this application was installed (as a Unix timestamp).
(eg.
1234567890
)
↳
time_updated
integer
Date and time when this install was last updated (as a Unix timestamp).
(eg.
1234567890
)
↳
title
string
Title of the website, used in Installatron only.
(eg.
My blog
)
↳
url
string
Address where this website is viewed online.
(eg.
https://website.com/blog
)
↳
url_domain
string
domain portion of the url parameter.
(eg.
website.com
)
↳
user
string
Installatron Server user that owns this install.
(eg.
useraccountname
)
↳
version
string
Application's (as currently used by this website) version.
(eg.
1.2.3
)
↳
version_autouped
string
The version that Installatron last automatically updated the website's application to. Note that the user may have manually updated the app to a newer version since this Automatic Update happened.
(eg.
1.2.3
)
↳
version_autouped_attempts
integer
The number of failed attempts, by Installatron, to update the website's application. Installatron will stop trying to update this application after 3 failed attempts. This count resets after a successful update.
(eg.
2
)
↳
version_available
string
Highest version of the application that Installatron can update the application to, from the version the website is currently using.
(eg.
4.5.6
)
↳
version_available_minor
string
Highest minor version of the application that Installatron can auto-update the application to, from the version the website is currently using.
(eg.
1.2.8
)
↳
version_updates_available
integer
Total number of new versions available for this website's application.
(eg.
11
)

Full Examples

Example: View meta data about a backup

Method: curl
Installatron Product: Installatron Server (switch to Installatron Plugin)
curl -X POST https://{SERVER_IP}/backups/1234567890abcdefghij12345 \
    -H 'X-API-KEY: {the key= or key2= value from /usr/local/installatron/etc/settings.ini}' \
    -H 'X-HTTP-Method-Override: GET' \
    -H 'Accept: application/json'
Response: json
{
    "result": true,
    "status": 200,
    "errcode": null,
    "errfield": null,
    "message": "The task is complete.\n"
    "data": {
        "backup_filename": "app__My-blog_2020-12-31_23-59-59.tar.gz",
        "backup_install": "1234567890abcdefghij12345",
        "backup_location": "local",
        "backup_note": "This is my safest backup",
        "backup_time": "1234567890",
        "id": "1234567890abcdefghij12345",
        "application": "wordpress",
        "agent": "5.0.0",
        "autobk": "schedule",
        "autobk_schedule": "1234567890abcdefghij1234567890ab",
        "autoup": "minor",
        "autoup_backup": "all",
        "autoup_plugins": "none",
        "autoup_themes": "none",
        "bkloc": "local",
        "cache_numerrors": 1,
        "cache_numwarnings": 0,
        "cache_files": 12345678,
        "cache_numbackups": 0,
        "cache_preview": 12345,
        "cache_tables": 123456,
        "cache_time": 1234567890,
        "db_host": "localhost",
        "db_type": "mysql",
        "db_name": "databasename",
        "db_user": "databaseusername",
        "db_pass": "dAtAbAsEpAs5//0rD",
        "db_prefix": "wp_",
        "login": "admin123",
        "email": "admin@website.com",
        "language": "en",
        "sitetitle": "My blog",
        "sitetagline": "Just another WordPress site",
        "limitloginattempts": "yes",
        "twofactor": "no",
        "failures": [],
        "file": "/home/useraccountname/.appdata/current/1234567890abcdefghij12345",
        "files": [
            "index.php",
            "license.txt",
            ".htaccess",
            ".maintenance",
            "readme.html",
            "wp-activate.php",
            "wp-admin",
            "wp-app.php",
            "wp-blog-header.php",
            "wp-comments-post.php",
            "wp-config.php",
            "wp-config-local.php",
            "wp-config-sample.php",
            "wp-content",
            "wp-cron.php",
            "wp-includes",
            "wp-links-opml.php",
            "wp-load.php",
            "wp-login.php",
            "wp-mail.php",
            "wp-settings.php",
            "wp-signup.php",
            "wp-trackback.php",
            "xmlrpc.php"
        ],
        "incomplete": true,
        "link_admin": "wp-admin",
        "notification": [],
        "parent": "1234567890abcdefghiparent",
        "path": "/home/useraccountname/public_html/staging",
        "plugins": [
            {
                "id": "akismet",
                "version": "5.3.6",
                "activated": false,
                "autoup": "all"
            },
            {
                "id": "limit-login-attempts-reloaded",
                "version": "2.26.18",
                "activated": true,
                "autoup": "all"
            }
        ],
        "stage": "1234567890abcdefghijstage",
        "tables": [
            "wp_commentmeta",
            "wp_comments",
            "wp_links",
            "wp_options",
            "wp_postmeta",
            "wp_posts",
            "wp_term_relationships",
            "wp_term_taxonomy",
            "wp_termmeta",
            "wp_terms",
            "wp_usermeta",
            "wp_users"
        ],
        "themes": [
            {
                "id": "twentytwentythree",
                "version": "1.6",
                "active": false,
                "autoup": "all"
            },
            {
                "id": "twentytwentyfive",
                "version": "1.1",
                "active": false,
                "autoup": "all"
            }
        ],
        "time_created": 1611356510,
        "time_updated": 1647057773,
        "title": "My blog stage",
        "url": "http://website.com/staging",
        "url_domain": "website.com",
        "user": "useraccountname",
        "version": "6.7.2",
        "version_autouped": "6.7.2",
        "version_autouped_attempts": 1,
        "version_available": "6.7.3",
        "version_updates_available": 3
    }
}


© 2004 - 2025 Installatron LLC. All rights reserved. Privacy Policy.