Alpha Authentication
Connecting the Revit Add-In to the Alpha platform
Authentication
The add-in authenticates with the Alpha platform using API keys. Each environment (dev, accept, production) has its own API key.
Getting an API Key
- Log in to the Alpha platform
- Navigate to your user profile or API settings
- Generate or copy your API key
Entering Your API Key
- In Revit, click Settings in the Alpha ribbon's Preferences panel
- Select the environment you want to configure (dev, accept, or production)
- Paste your API key into the corresponding field
- Click Save
The settings window provides separate API key fields for each environment:
| Field | Environment URL |
|---|---|
| Dev API Key | https://alpha.kube.asrr.nl/api/v1 |
| Accept API Key | https://staging.kube.asrr.nl/api/v1 |
| Production API Key | https://prod.alpha.kube.asrr.nl/api/v1 |
How Validation Works
When you save settings or switch environments, the add-in validates your API key by calling the /user/me endpoint. If the key is valid, you will see your email address displayed in the settings window.
If validation fails, you will see an error message. Common causes:
- Invalid API key — double-check that you copied the full key
- Wrong environment — ensure the key matches the selected environment
- Network issues — verify your internet connection and firewall settings
Switching Environments
Select the target environment from the dropdown in the Settings window. The add-in will use the API key associated with that environment for all API calls, including exports and type lookups.
The active environment determines which Alpha instance receives your exported models and configuration data.