Export files using API

You can export bots with their dependent files using the Export API.

Подготовка

Прим.: You can view the Control Room APIs in the Community Edition, but API functionality is limited. You need a licensed Automation 360 Edition to access the full functionality of the APIs.

You must have Export bots, View package, and Check in or Check out permissions to the required folders.
All API calls must contain either an authentication token from Authentication API (generates JSON Web token) or a bearer token from OAuth services. You cannot use both together in an API.
A file ID of the bot you want to export from the public folder.
List files and folders by workspace API
Прим.: Users can only view the folders and subfolders they have permissions to access.
The following API URLs:
- https://<your_control_room_url>/v2/blm/export: To export repository bots
- https://<your_control_room_url>/v2/blm/status/{requestId}: To get export status by request ID
- https://<your_control_room_url>/v2/blm/downoad/{downloadFileId}: To download the exported bot

Процедура

Add the authentication token or bearer token to the request header. You cannot use both in the same API.
Search for one or more file IDs of the bot you want to export.
Use the POST method and endpoint URL:https://<your_control_room_url>/v2/blm/export.
The following example request body, exports the bot with fileId 2197 along with the packages required for bot.
Request body:
```
{
  "name": "export-docs",
  "fileIds": [
    2197
  ],
  "includePackages": true
}
```
Send the request.
The following response body returns the requestId.
Response body:
```
{
  "requestId": "987c0de3-b158-4e71-975e-27d10b9a83fb"
}
```
Use the GET method and endpoint URL: <your_control_room_url>/v2/blm/status/{requestId}
Enter the requestId generated in Step 4 to know the status of export.
```
https://192.0.2.0/v2/blm/status/987c0de3-b158-4e71-975e-27d10b9a83fb
```

Send the request.

The following response body returns the status and downloadFileId.

Response body:

{
  "requestId": "987c0de3-b158-4e71-975e-27d10b9a83fb",
  "type": "EXPORT",
  "status": "COMPLETED",
  "downloadFileName": "export-docs",
  "downloadFileId": "ZXhwb3J0LWRvY3M=",
  "errorMessage": ""
}

Use the GET method and endpoint URL: <your_control_room_url>/v2/blm/download/{downloadFileId}
Enter the downloadFileId generated in Step 6.
```
https://192.0.2.0/v2/blm/download/ZXhwb3J0LWRvY3M=
```
Send the request.
The dialog box appears. Browse the path and save the exported package in zip file format.
The REST API responds to each request with an HTTP response code. For response codes, see API response codes.

Дальнейшие действия

Import the exported file in the private folder of the target Control Room.