Authentication
First, we need to authenticate with Datapane Cloud or a Datapane Teams server.
Datapane has a server component which you can access through the CLI and Python library and requires an authentication token. You can authenticate through either the CLI or the Python library, and all future requests will automatically be authenticated.
Datapane Cloud
Datapane Cloud is hosted on datapane.com and is available as a free server where you can upload reports. The API and CLI are configured to use this server by default.
Sign up
You can sign up for a free account via our website or via CLI:
Login
After this, you'll see a code snippet with datapane login
and your token. Login by running this code snippet or Python library using this key. All future requests from both the CLI and Python library will automatically be authenticated. Reports are unlisted by default, and you can share them publicly or privately (see Uploading and Sharing).
Info
If you need your API key in the future, you can find it in your settings page.
Datapane Teams
Datapane Teams provides private hosted servers and supports on-premise instances for organizations. In such a case, log in to your instance, for instance https://your-company.datapane.net
, using the credentials provided to you by your admin.
Similar to when using the free Datapane instance, your home page will indicate your API key and you will be able to authenticate by passing in your API key to the login command. You will need to pass in the full URL of your server (including the https://
) to the login command as follows.
Info
The CLI supports multiple profiles using the --env flag, so you can easily work with both the default Datapane instance and your private enterprise instance at the same time.
Check your Authentication
To check you have access and which account you are logged in as, run: