Einführung
Level's public API lets you interact with your devices, groups, automations, and more programmatically. It's a standard REST API: resource-oriented URLs, JSON responses, and HTTP status codes.
Full API reference: developers.level.io
⚙️ PREREQUISITES
Level administrator access (to generate an API key)
Level Public API
Generate an API Key
Every API request requires authentication via an API key.
In Level, navigate to Einstellungen → API Keys.
Klicken Sie auf Erstellen Key.
Give the key a descriptive name that identifies the integration or script it's for (for example, "Monitoring Dashboard" or "Custom Sync Skript").
Klicken Sie auf Speichern and copy the generated key.
💡 TIPP: Erstellen one API key per integration or script. This makes it easier to rotate or revoke access for a specific use case without affecting others.
Using the API
All requests are authenticated with your API key. Refer to the API reference at developers.level.io for endpoint documentation, request formats, and example responses.
The API follows standard REST conventions:
Resource-oriented URLs
JSON request and response bodies
Standard HTTP verbs:
GET,POST,PUT,DELETEStandard HTTP status codes for success and error states
Manage API Keys
API keys are managed at Einstellungen → API Keys. From there you can:
Ansicht all active keys and their names
Regenerate a key (invalidates the old one immediately)
Löschen a key to revoke access
⚠️ WARNING: Regenerating or deleting a key immediately breaks any integration or script that uses it. Update the key in all dependent systems before rotating.
Häufig gestellte Fragen
Who can create API keys? Level administrators. API key management is under Einstellungen → API Keys.
Is there a limit on how many API keys I can create? Nein, there is no limit. As a general practice, create one key per integration rather than sharing a single key across multiple systems.
What can I do with the API? The full capability list is in the reference docs at developers.level.io. Common use cases include querying device status, triggering automations, managing groups and tags, and building custom dashboards or reporting integrations.
How do I authenticate API requests? Include your API key in the request header. The exact header format is documented at developers.level.io.
What do I do if an API key is compromised? Löschen it immediately at Einstellungen → API Keys. Generate a new key and update all integrations that used the old one.