Skip to main content

Account Token

Account Tokens are the secret keys used between Tago and external applications. Any access from an account requires a valid token, so it is vital that tokens are kept secret and only shared with trusted parties.

warning

All sorts of requests can be performed with Account Tokens, so only provide this token to trusted applications.

Managing Account Tokens

Account tokens can be managed from your account details by selecting your profile. You can copy a token by clicking the Copy button.

More than one token can be created for the same profile. Permissions and expiration dates for each token may be configured as needed.

Types of Permissions

  • Full – full permission to manage all entities from your account, including read, create, update, and delete.
  • Write only – create and update all entities from your account.
  • Read only – read all entities from your account.

Entities Authenticated by Account Tokens

  1. Devices
  2. Dashboards and Widgets
  3. Analysis
  4. Actions
  5. Files
  6. Access Management
  7. TagoRun and Run users
  8. Dictionary

Expiration and Auto-Generated Tokens

The expiration field defines the lifespan of a token; it can be set to a temporary period or left infinite (never expires).

A new token is automatically generated each time you log in to your account, or when someone with whom you have shared your profile logs in. These auto‑generated tokens are created with an expiration time of 3 months and will be deleted automatically after that period or when the user logs out of the account manually.