Attention: Due to an upgrade beginning on Friday, the 22nd August 2025, any new collabs, groups and any changes to teams will not be kept beyond the weekend. User creation will also be disabled during this time. The actual upgrade will take place on Wednesday, 27th August. On that day, any service requiring a Keycloak login will be unavailable for the duration of the upgrade. Thank you for your understanding as we complete this important work.

For the duration of the maintenance period, Collaboration and Group creation features will be temporarily disabled and will return HTTP 503 Service Unavailable errors until further notice.


Interacting with the drive

Last modified by allan on 2020/03/10 13:57

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