Import & export API

Table of contents

Import & export API provides users the ability to transfer Mission Portal data between hubs.

Get available items to export

This API call provides a list of items available for export. Please note that the role of the user that authenticates to this API will affect what items are available. For example: the API user must have admin role in order to export settings.

URI:https://hub.example/data_transfer/api/exportItems

Method: GET

Example request (curl):

code

curl -k --user <username>:<password> \  -X GET \  https://hub.example/data_transfer/api/exportItems

Example response:

code

HTTP 200 Ok[    {        "id": "categorizations",        "name": "Host categorizations"    },    {        "id": "dashboards",        "name": "Dashboards"    },    {        "id": "reports",        "name": "Reports"    },    {        "id": "settingsScripts",        "name": "Custom notification scripts"    },    {        "id": "users",        "name": "Users"    },    {        "id": "settingsRoles",        "name": "Roles"    },    {        "id": "settingsPreferences",        "name": "Preferences"    },    {        "id": "settingsAuthentication",        "name": "LDAP authentication settings"    },    {        "id": "settingsMail",        "name": "Mail settings"    },    {        "id": "settingsVCS",        "name": "Version control repository"    }]

Output:

idItem id. Use this id in export API call.
nameName of export item.

Export

URI:https://hub.example/data_transfer/api/export

Method: GET

Parameters:

item_id(array)Item id to be exported.List of item ids you can obtain throughList of items to export call described below.
encryptionKey(string)Encryption key to encrypt sensitive data. Please save this key to be able to import the data.
exportOnlyUserItems(string)true - export only user items.false - export whole system data

Example request (curl):

code

curl -k -g --user <username>:<password> \  -X GET \  'https://hub.example/index.php/data_transfer/api/export?encryptionKey=key&exportOnlyUserItems=true&items[]=categorizations&items[]=dashboards&items[]=settingsAuthentication&items[]=settingsMail'

Example response:

code

HTTP 200 Ok{    "name": "export_12-14-2018_15:19:40.381400.phar",}

Output:

nameName of export file.
urlUrl of export file.

Download export file

URI:https://hub.example/data_transfer/api/download/:file_name:

Method: GET

Parameters:

file_name(string)File name to be downloaded.

Example request (curl):

code

curl -k -g --user <username>:<password> \  -X GET \  --output /save/file/here/export_12-14-2018_15:19:40.381400.phar \  'https://hub.example/index.php/data_transfer/api/download/export_12-14-2018_15:19:40.381400.phar'

Example response:

code

HTTP 200 OkRaw file contetnt

Output headers:

Cache-Control: must-revalidate, post-check=0, pre-check=0
Pragma: public
Content-Description: File Transfer
Content-Disposition: attachment; filename="export_12-14-2018_16:04:46.093500.phar"
Content-Length: 337801
Content-Type: application/octet-stream

Analyze import file

This API call allows you to see short summary of file content.

URI:https://hub.example/data_transfer/api/analyzeImportFile

Method: POST

Parameters:

file(form data file)File to be analyzed.

Example request (curl):

code

curl -k --user <username>:<password> \-X POST \-F file=@/path/to/file.phar  \'https://hub.example/index.php/data_transfer/api/analyzeImportFile'

Example response:

code

HTTP 200 Ok{    "categorizations": 3,    "dashboards": "4, Widgets: 21 , Alerts: 31, Rules: 7",    "settingsAuthentication": "yes",    "settingsMail": "yes"}

Import

URI:https://hub.example/data_transfer/api/import

Method: POST

Parameters:

file(form data file)File to be analyzed.
encryptionKey(string)Encryption key that was set while export.
skipDuplicates(number)Merge conflict strategy:1 - skip duplicate items.0 - overwrite duplicate items.

Example request (curl):

code

curl -k --user <username>:<password> \-X POST \-F file=@/path/to/file.phar  \-F encryptionKey=key \-F skipDuplicates=1 \'https://hub.example/index.php/data_transfer/api/import'

Example response:

code