Warning:  Due to planned infrastructure maintenance, the EBRAINS Wiki and EBRAINS Support system will be unavailable for up to three days starting Monday, 14 July. During this period, both services will be inaccessible, and any emails sent to the support address will not be received.

Attention: We are currently experiencing some issues with the EBRAINS Drive. Please bear with us as we fix this issue. We apologise for any inconvenience caused.


Interacting with the Drive

Version 2.1 by chaney08 on 2021/07/20 19:52

REST API

The drive is based on Seafile. Seafile comes with a restful API which allows you to interact with the content and libraries. You can find the documentation for the Seafile API here: https://download.seafile.com/published/web-api/home.md

The Collaboratory.Drive is protected using OpenID Connect. The authentication is done by using access tokens. You need to have an application which the user logs into to obtain a token for the user. This application will need an OpenID Connect client to be registered. You can find instructions here: Creating Your OpenID Connect Client.

In order to read from the Collaboratory.Drive, you currently need the `collab.drive` and `email` scopes. In the near future, you will need the `email` scope, as well as the`clb.drive:read` scope to access documents, and the `clb.drive:write` scope to make changes. You can already request these scopes to future proof your application.

To authenticate to the API, you add an `Authorization` header to the HTTP request with the content `Bearer {TOKEN}`.

curl -H "Authorization: Bearer $access_token" https://drive.ebrains.eu/api2/...

 

Table of content