API keys let you securely authenticate with Blnk Cloud APIs. They allow your applications, scripts, and automated workflows to interact with Blnk Cloud programmatically.
You can manage your API keys in Settings > API Keys.
Keep your API keys secure and rotate them regularly. API keys provide full access to your account based on their assigned scopes. Never share API keys publicly or commit them to version control.
How API keys work
When you make an API call, include your API key in the request headers to verify your identity and authorize the operation on your Cloud workspace.
Each API key has:
- Name: A user-friendly identifier to help you organize and identify keys
- Key prefix: A partial identifier visible in the API keys list (e.g.,
blnk_fdb796a5...)
- Scopes: Permissions that define what the key can access (e.g.,
* for all permissions, or specific scopes like mcp:read, mcp:write)
Role: Always set to Member (cannot be changed)- Expiration: Optional expiration date, or “Never” for keys that don’t expire
Create an API key
Navigate to API Keys
- Go to
Settings > API Keys in your Blnk Cloud dashboard.
- Click
Create API Key button in the top-right corner of the API Keys page.
Configure your API key
Fill in the required information:
- Name: Enter a descriptive name for your API key (e.g., “Production API Key”, “Testing”, “Alerts Integration”)
Scopes: Select the permissions for this key:
* for all permissions- Specific scopes like
mcp:read, mcp:write for limited access
Expires: Choose when the key should expire:
- Select a specific date
- Choose “Never” for keys that don’t expire
Save and copy your API key
After creating the key, the full API key will be displayed only once. Copy it immediately and store it securely.You cannot retrieve the full API key after creation. If you lose the key, you must create a new one.
Revoke an API key
If you need to disable an API key without deleting it permanently, you can revoke it. Revoked keys cannot be used for authentication but remain visible in your API keys list for reference.
Open API key details
Click on the API key name in the API Keys table to view its details.
Revoke the key
In the API key details panel, click the Revoke Key button.Revoking a key will immediately disable it. Any applications or scripts using this key will stop working until you create and configure a new key.
Confirm revocation
Confirm that you want to revoke the key. The key’s status will change to “Revoked” in the API Keys table.
Need help?
We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.
To ask questions or discuss issues, please contact us or join our Discord community.
