Skip to main content

API Tokens

API access tokens are the credentials needed to access the Astrocast API.

An access token is used in two scenarios:

tip

For security reasons, we recommend you to create a separate API access token for each application. In case one of your tokens is compromised, you can revoke that specific access token.

Create an access token

img

  1. Go to the Astrocast Portal.
  2. Scroll down to the Access Tokens section.
  3. Click on to create a new access token.
  4. Enter the access token Name, the Expiration date and the Role.
  5. Click on Create.
  6. 🗒️ Copy the access token and store it in a safe place.
caution

You are responsible of storing your access token in a secure location. Astrocast cannot retrieve an access token if you lose one.

Edit an access token

  1. Go to the Astrocast Portal.
  2. Scroll down to the Access Tokens section.
  3. Click on 🖊️ to edit an access token.
  4. Update the access token Name, the Expiration date and/or the Role.
  5. Click on Update.

Delete an access token

img

  1. Go to the Astrocast Portal.
  2. Scroll down to the Access Tokens section.
  3. Click on 🗑️ to delete an access token.
  4. Confirm.

Role description

Role NameDescription
OwnerGrants full access to manage all resources, including the ability to assign roles.
ContributorGrants full access to manage all resources, but does not allow you to assign roles.
ReaderView all resources, but does not allow you to make any changes.
Wi-Fi DevKitAllows to send messages and retrieve unicast commands.
Device EngineerGrants full access to devices including control commands.
note

Go to the Astrocast Portal / Role to find full roles description.