Exporting and importing content into a space

Export a Room

The current state (ie. the tabs and their respective content) of a room can be exported to a ZIP file. This ZIP can later be imported into a new room with all the saved data from the exported state. In the Space, this is done using the Export button but this can also be achieved using some API calls.

However, instead of the Lessonspace API, the room.sh API has to be called directly and the url subdomain is dependent on the region of the room's server. As authorization, the room secret has to be passed in the headers. The secret and the subdomain can be found in the secret and api_base field of the response when making a call to the launch endpoint. The request schema is given below and the room.sh api reference is given here.

curl -L \
    -H 'Authorization: secret {room_secret}' \
    -o exportRoom.zip \
    -X GET https://{region}.room.sh/v1/rooms/{room_uuid}/export

Import a Room, PDF or Office document

If you have previously exported the state of a room to a ZIP file, this ZIP file can be imported in a new room to restore the previous state. Additionally both PDF and Office documents can be imported. This is done in a similar fashion to the export (with some slight modification). The request schema is given below and the room.sh api reference is given here. Note that the secret and room_uuid are that of the target room.

curl \
    -H 'Authorization: secret {room_secret}' \
    -F 'files=@{path/filename}.zip' \
    -X POST https://{region}.room.sh/v1/rooms/{room_uuid}/import