API Tokens

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

An access token is used in two scenarios:

• To pull data from the Astrocast API.
• To authenticate your Astronode Wi-Fi DevKit while sending messages.

tip

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

Create an access token

In order to create a new access token,

1. Go to the Astrocast Portal.
2. In the bottom left corner, click on ⚙️ Settings.
3. Click on Access Tokens.
4. Click on ➕ create new access token.
5. Enter the access token's Name, set an Expiration date and assign a Role.
6. Click on Create.
7. 🗒️ 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

In order to edit the parameters of an access token,

1. Go to the Astrocast Portal.
2. In the bottom left corner, click on ⚙️ Settings.
3. Click on Access Tokens.
4. Click on 🖊️ to edit an access token.
5. Update the access token Name, the Expiration date and/or the Role.
6. Click on Update.

Delete an access token

When you prefer to delete an access token,

1. Go to the Astrocast Portal.
2. In the bottom left corner, click on ⚙️ Settings.
3. Click on Access Tokens.
4. Click on 🗑️ to delete an access token.
5. Confirm.

Role description

Role Name	Description
Owner	Grants full access to manage all resources, including the ability to assign roles.
Contributor	Grants full access to manage all resources, but does not allow you to assign roles.
Reader	View all resources, but does not allow you to make any changes.
Wi-Fi DevKit	Allows to send messages and retrieve unicast commands.
Device Engineer	Grants full access to devices including control commands.

note

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