Skip to main content

Personal Access Tokens

Use a personal access token to call the IOMETE API from code or scripts, instead of your password.

Creating a Token​

  1. Go to Settings > Access Tokens and click New access token.
  2. Enter a Token name, pick an Expiration, and click Create.
  3. Copy the token.
Create access token form | IOMETECreate access token form | IOMETE
You see the token only once

Copy it right away and keep it somewhere safe, such as a password manager. If you lose it, delete it and create a new one.

Access token created, with a Copy button | IOMETEAccess token created, with a Copy button | IOMETE

New tokens start with iomt_. Older tokens without it keep working.

Using a Token​

Send the token in the X-API-Token header. Replace {your_iomete_host} with the address you use to open IOMETE.

import requests

r = requests.get("https://{your_iomete_host}/api/v1/....", headers={
    "X-API-Token": "iomt_**************************"
})

Managing a Token​

Open the ⋮ menu next to a token:

ActionWhat it does
SuspendBlocks the token right away. Turn it back on with Activate. Not available for expired tokens.
RenameChanges only the name. Anything using the token keeps working.
DeleteRemoves the token for good.
Token actions menu with Suspend, Rename, Copy name and Delete | IOMETEToken actions menu with Suspend, Rename, Copy name and Delete | IOMETE
Need a request limit?

To cap how many requests per second a token can make, use a service account token.

Expiry Notifications​

IOMETE can email you before a token expires. See Access Token Expiry Notifications.

ON THIS PAGE