The current API supports only one type of authentication: user generated Personal Access Tokens. Workspaces do not have their own access tokens.

Every API endpoint requires authentication, except the “root” URL (

Acquiring a Personal Access Token

  1. Sign in on
  2. Go to your Account Settings page.
  3. Select the Security tab on the left side.
  4. Click the Generate new token button to create a new Personal Access Token.
  5. Save the generated token.

Availability of the generated token

The generated token is shown only once: when it’s generated. There’s no way to see the token value again! You can of course generate as many Access Tokens as you like, and delete the ones you don’t need anymore.

Authenticating with the API

To provide the required access token, you have to add a HEADER to your requests, with the key Authorization and the value of your token.

An example API call with auth, using curl:

curl -H 'Authorization: THE-ACCESS-TOKEN'