Skip to main content

Python library for the Kloudless API

Project description

Python library for the Kloudless API

Python library for the Kloudless API.

You need to sign up and create an application first before using this SDK.

Table of Contents


Python 2.7 or Python 3.5+


Install via pip:

pip install kloudless

Install from source:

git clone git://
cd kloudless-python
python install

Getting Started

Most Kloudless API endpoints require connecting to an upstream service account first. Start by navigating to API Explorer and connecting an account.

Get the Bearer Token

After the account has been connected, copy the Bearer Token from the text box and use it to initialize an Account object:

from kloudless import Account
account = Account(token="YOUR_BEARER_TOKEN")

Making API Requests

You can now make an API request with the account instance you've created.

If Connecting to a Storage Service

# retrieve folder contents
root_folder_contents = account.get('storage/folders/root/contents')
for resource in root_folder_contents:

# download the first file in root_folder
for resource in root_folder_contents:
    if['type'] == 'file':
        filename =['name']
        response = resource.get('contents')
        with open(filename, 'wb') as f:

# upload a file to root_folder
file_name = 'FILE_NAME_TO_UPLOAD'
headers = {
    'X-Kloudless-Metadata': json.dumps(
        {'parent_id': 'root', 'name': file_name}
with open(file_name, 'rb') as f:
    file_resource ='storage/files', data=f, headers=headers)

If Connecting to a Calendar Service

# retrieve primary calendar
calendar = account.get('cal/calendars/primary')
print('Primary Calendar: {}'.format(['name']))

# iterate through events in first page with page_size equals 5
events = calendar.get('events?page_size=5')
for e in events:
    data =
    print('{}: {}~{}'.format(data['name'], data['start'], data['end']))

# iterate thorough events in second page
next_page_events = events.get_next_page()
for e in next_page_events:
    data =
    print('{}: {}~{}'.format(data['name'], data['start'], data['end']))

# create a new event on primary calendar
event ={
    'start': '2019-01-01T12:30:00Z',
    'end': '2019-01-01T13:30:00Z',
    'name': 'Event test'}

Integrating OAuth Flow

You can use the Authenticator JS library to authenticate end-users via a pop-up and store the token server-side. Be sure to verify the token once it is transferred to your server. See kloudless.application.verify_token.

An alternate approach is to use the OAuth Authorization Code grant flow to redirect the end-user to Kloudless to connect their account to your app.

OAuth Integration Demo server

examples/ provides the server-side logic of the 3-legged OAuth flow using helper methods from the Kloudless Python SDK. See examples/ for instructions on running the demo server.

Python Django Sample code

Insert the following code into Django views under views/ directory and calling it via

from django.http import HttpResponseRedirect, HttpResponse
from django.conf import settings

from kloudless import get_authorization_url, get_token_from_code

def start_authorization_flow(request):
    Redirect the user to start authorization flow.
    url, state = get_authorization_url(app_id=settings.KLOUDLESS_APP_ID,

    request.session['authorization_state'] = state
    return HttpResponseRedirect(url)

def callback(request):
    The endpoint for settings.KLOUDLESS_REDIRECT_URL.
    params = request.GET.dict()
    token = get_token_from_code(app_id=settings.KLOUDLESS_APP_ID,

    # store the token
    request.user.kloudless_token = token
    return HttpResponse('Account connects successfully.')


Full documentation is hosted at Read the docs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kloudless, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size kloudless-2.0.0-py2.py3-none-any.whl (16.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size kloudless-2.0.0.tar.gz (12.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page