specs/routes/R_APIT

Settings - API Tokens

Overview

A "API Token" is a combo of an API key and a secret alphanumeric code that allows anybody to read or write to Tulip's database.

Access is controlled via the API key and secret, and can always be turned off at any point. The "secret" will only be displayed once.

The page also links to the official API documentation, which is listed under the route "/apiDocs" and shows different examples of how to use the API. It can be accessed via the link "API Documentation" in the top right of the screen.

Model/Page Connections

API Tokens

Create

  • A user can create a API token by pressing the "Create API token" button in the top right of the screen.

Edit

  • A user can edit all properties of the API token except for the API Key, secret and auth header by clicking the "pencil" icon next to each API token on the right side of the screen.

View

  • A user can view all API tokens in the account on the list in the middle of the screen. They can view the current scopes for each API token by clicking the "Edit" pencil next to each API token.

Deactivate

  • A user can turn off a API token's access to Tulip by flipping the toggle in the "Enabled" column next to each API token to the left, or "disabled", position. API tokens cannot be deleted.

Pages

This page can be accessed from:

User Permissions

A user can view, edit, create and deactivate API token with the following permissions:

  • "Edit API Tokens"
  • "Full Access" to Workspace Settings
  • "Full Access" to Account Settings

Tests

IDName
QA-T579API Tokens : 01 - Creating, Editing, and Disabling API Tokens
QA-T1282Creating Global and Worksapce-Scoped API Tokens

Requirements

No requirements