How do permanent and temporary API tokens work in Honeycomb?

You can create permanent and temporary API tokens in Honeycomb. Permanent tokens are often more convenient, but you can choose between them depending on your needs.

Permanent tokens

Permanent tokens can be created in Honeycomb. You can use them to give an application permanent access to the Honeycomb data. By setting up this token, the application can access this measurement data without needing to log in to our Honeycomb platform first. A permanent token erases the need for you to write code requesting tokens and handling expired tokens. Permanent tokens stay active indefinitely unless you remove their access.

You can create several permanent tokens. It is important to note that these tokens are only shown once after creation, so store them in a safe and accessible place.

Learn how to set up permanent API tokens in this knowledge article.


Temporary tokens

Temporary tokens are helpful when working with an application that does not know about tokens in advance. Instead of working with a token directly, a POST username and password suffice to automatically create an API token for the application user.

The temporary token remains active for 14 days. If used within this period, the token will automatically renew its active status for another 14 days, and so on. Consequently, the same token can be used for a long time if activated regularly.

If not active for 14 days, the token will expire, and you will need to create a new one using the same method as before:

Learn how to create a temporary API token in this knowledge article.

You can create only one temporary token. If you attempt to create a second token while another temporary token is still active, the first token will be returned. This means that, should you forget to store the token in a safe and accessible place within the 14-day period, you can simply re-request the token to make it visible again.