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. In case one of your tokens is compromised, you can revoke that specific access token.

Create an access token

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

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 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.