API reference


Mode is a collaborative analytics platform that lets teams work together to solve problems and make better decisions with data.

Mode’s Application Programming Interface (API) powers its analytics platform. You can use the Mode API to programmatically retrieve information from Mode and interact with its rich array of analytics functions. These include writing queries, building, sharing, or distributing reports, and managing members, workspaces, and data.

See the full documentation for Mode's API here

Generating API tokens

API tokens allow you connect to Mode's API programmatically. An API token is used instead of your email address and account password whenever you programmatically authenticate to Mode with basic authentication.

WARNING: Remember to store your API token and password securely. Do not expose the password on public sites, in client-side code, or in public code repositories.

You can create or destroy API tokens for your Mode user account from your account's settings:

  1. Navigate to your Mode homepage.
  2. Click on your name in the upper left corner and click My Account.
  3. Click on API Tokens on the left side.

To generate a new API token and password, enter a token name and click Create token. You will then see the following:

New API token

The credentials are comprised of two parts:

1) Token: The public component of the credential. Often referred to as the username or access key during authentication.

2) Password: The private component of the credential. Often refereed to as the password or access secret during authentication.

API tokens are tied to your Mode user account, not to a specific Mode Workspace. An API token and password generated for your Mode account will provide access to all resources your user account has access to across all Mode Workspaces to which you belong.

Click Delete next to any current token that you would like to invalidate.

Was this article helpful?

decorative particle

Get our weekly data newsletter

Work-related distractions for every data enthusiast.