Accessing Your APIs
Last updated
Last updated
At Connected Devices > Your APIs, you will find a list of the different API functions we serve, and for each one:
A brief description of their usage.
Their endpoint.
Authentication tokens, which you can add, name, delete, or regenerate. See Connected Devices API Tokens below for more information.
A link to full documentation on our developer portal.
Unlike with other ThousandEyes API tokens, which are administered per user, Connected Devices API tokens can be used across an entire organization. For this reason, you are able to generate multiple tokens per API for use by different teams, different cost centers, or even different users. Multiple live tokens also better enable regular token rotation for improved security.
To further enhance security, Connected Devices API tokens are not viewable once they have been generated (or regenerated). This ensures any potential breach cannot expose your token. Learn more about how to manage your Connected Devices API tokens, below.
Under the relevant API, click Generate Token if no tokens have been added yet, or Add Token to add a token to the existing list.
In the resulting popup, give the key a unique and meaningful name and click Generate Token.
A new popup appears with the generated token and a button to copy it.
As API keys can only be viewed upon initial generation or regeneration, a message explains that the token will be obfuscated after closing the popup. You should copy it or note it down and store it in a safe place.
Click Got it when you've copied and safely stored your token.
If you do try to view the token, a tooltip explains that you cannot for security reasons.
Above the token field, you can view the name of the token as well as the date and time the token was either "created" (first generated) or "regenerated" (most recently regenerated).
There is no maximum on the total number of tokens per API you can add, though we reserve the right to limit them.
Tokens that existed before 17 September 2024 appear with the name "untitled". You cannot currently edit the name of a token. You must delete the token and add a new one in order to rename it. If regenerating a token without a name (i.e. “untitled”), the new token will be considered to have the name "untitled".
Next to the relevant token field, click Regenerate to create a new token under the same token name or Delete to remove the token entirely.
A confirmation dialog warns that this is an irreversible action that requires updating all connected applications. Remember also that these keys are shared across the organization; regnerating or deleting the key invalidates the existing stored key potentially used by others.
If you wish to continue, click Regenerate or Delete in the respective popups.
It is possible to have no tokens listed under the API.
You may delete the last token to make the token list empty, though see Regenerating and Deleting Tokens to understand the risks of deleting a token.
List items are sorted by their “Created at” or "Regenerated at" date, putting the most recent action first.
