Create website backup available since version 4.0.0 / 3.7.316 On-Premises

Creates site source file backup and stores locally on builder server or returns as downloadable file.

JSON Object Properties:

• String domain - domain name used to identify website witch will be backed up (required).
• String dir - absolute folder path inside builder server where to store backup file (optional, if not set backup file will be returned in response for downloading). When backup file is stored locally in provided folder it will have file name: "[domain]_project.sitebuilder".

On success you get empty response (in case of local storage) or response with a file for downloading. HTTP response code should be 200.
On error you will get JSON encoded object as response. HTTP response code should be something other than 200.

Response on Error JSON Object Properties:

• Object error - error description object (only on error). Error object structure:
  • Number code - error code
  • String message - text describing the error

Request example (when storing locally):

POST /api/create-site-backup HTTP/1.1
Host: your-on-premises-builder-domain.com
Authorization: Basic W0FQSSBVc2VybmFtZSBmcm9tIGJyYW5kXTpbQVBJIFBhc3N3b3JkIGZyb20gYnJhbmRd
Content-Type: application/json

{
    "domain": "site-to-backup.com",
    "dir": "/mnt/backup_storage"
}

Response on success (when storing locally) example:

HTTP/1.1 200 OK

Response on success (when downloading) example:

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-disposition: attachment; filename="site-to-backup.com_project.sitebuilder"

[some binary data]

Response on error example:

HTTP/1.1 500 Internal Error
Content-Type: application/json

{"error": {"code": 1, "message": "some kind of error message"}}