Creating API Keys

API keys enable programmatic access to your measurement data. You can restrict them to specific permissions (scopes) and revoke them at any time.

Creating a Key

  1. Navigate to Data → API Tokens.
  2. Click New API Token.
  3. Enter a name and select the desired permissions.
  4. After creation, the token is shown on the detail page — you can copy it at any time.

Permissions (Scopes)

Group Scopes Access
Data data:read Read measurement values
Meters meters:read, meters:create, meters:update, meters:delete Read, create, edit, and delete meters
Consents consents:read, consents:request, consents:revoke Read, request, and revoke consents
Connections connections:read, connections:create, connections:update, connections:delete, connections:test Manage data delivery connections
Tokens tokens:read, tokens:create, tokens:revoke Manage API keys
Full access * All permissions

Only grant the permissions that an application actually needs.

Managing and Revoking Keys

All active keys are listed under Data → API Tokens. There you can see the name, permissions, creator, and last used timestamp.

To revoke a key, open the token and click Delete. The key becomes invalid immediately — any ongoing requests will receive a 401 error from that point on.