Catégorie : Settings | Mise à jour : 2026-03-17 | Afficher sur docs.level.io
Présentation
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
⚙️ CONDITIONS PRÉALABLES
Level administrator access (to generate an API key)
API publique Level
Generate an API Key
Every API request requires authentication via an API key.
In Level, navigate to Settings → API Keys.
Click Create Key.
Give the key a descriptive name that identifies the integration or script it's for (for example, "Monitoring Dashboard" or "Custom Sync Script").
Click Enregistrer and copy the generated key.
💡 CONSEIL : Create 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 Settings → API Keys. From there you can:
View all active keys and their names
Regenerate a key (invalidates the old one immediately)
Delete a key to revoke access
⚠️ ATTENTION : Regenerating or deleting a key immediately breaks any integration or script that uses it. Update the key in all dependent systems before rotating.
FAQ
Who can create API keys? Level administrators. API key management is under Settings → API Keys.
Is there a limit on how many API keys I can create? No, 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? Delete it immediately at Settings → API Keys. Generate a new key and update all integrations that used the old one.