Zum Hauptinhalt springen

API Keys Einstellungen

Heute aktualisiert

Einführung

API keys let external tools and scripts authenticate with Level's API. You can create multiple keys, scope each one to read-only or read-write access, and revoke any key independently without affecting the others.

Typical uses: connecting custom scripts, pulling device data into external dashboards, or building integrations that aren't covered by Level's built-in connectors.


Creating an API Key

Navigate to Einstellungen → API keys, then click + Erstellen API key in the top right.

API Key Einstellungen

The Erstellen API key modal opens.

API Key Modal
  1. Geben Sie ein a Description — something specific enough that you'll know what this key is for months from now. "Inventory sync" or "ConnectWise custom integration" is more useful than "API key 1."

  2. Wählen Sie an access level:

    • Read and write — can view data and create, update, or delete records

    • Read-only — can view data but can't create, update, or delete

  3. Klicken Sie auf Erstellen key.

💡 TIPP: Use read-only access for integrations that only need to pull data (reporting tools, external dashboards). Reserve read-and-write for integrations that need to make changes.


Managing Existing Keys

The API keys page lists all keys for your organization. Each row shows:

  • API key — masked value with the last few characters visible for identification

  • Description — the label you assigned at creation

  • Access — Read & write or Read-only

  • Last used — timestamp of the most recent authenticated request, or -- if never used

  • Erstellend — when the key was generated

Klicken Sie auf die three-dot menu at the end of any row to:

  • Copy key — copies the masked key identifier to your clipboard (not the full secret value)

  • Bearbeiten — update the description or change the access level

  • Löschen — permanently revoke the key

Bearbeitening a Key

Klicken Sie auf Bearbeiten from the three-dot menu. The Update API key dialog opens with the current description and access level pre-filled.

ℹ️ HINWEIS: Bearbeitening a key doesn't change the key value itself. Any integration already using this key continues to work — it picks up the new access level immediately.

Deleting a Key

Klicken Sie auf Löschen from the three-dot menu. The key is revoked immediately. Any integration or script using that key will start receiving authentication errors on its next request.

⚠️ WARNING: Key deletion is immediate and permanent. Update any integrations using the key before deleting, or expect them to fail.


Suchening Keys

Use the Suchen bar at the top of the list to filter keys by description. Useful if you've accumulated a lot of keys and need to find a specific one.


Häufig gestellte Fragen

  • Can I see the full API key value after creation? Ja. Klicken Sie auf die three-dot menu on any key and select Copy key to copy the full key value to your clipboard at any time.

  • How many API keys can I create? Erstellen as many as you need — one per integration is a reasonable practice since it lets you revoke individual integrations without affecting others.

  • What's the difference between read-only and read-and-write? Read-only keys can retrieve data from the API but can't make any changes. Read-and-write keys can create, update, and delete records. Use the minimum access level that your integration actually needs.

  • Who can create and manage API keys? Technicians with access to Einstellungen. See Workspace → Berechtigungs for details on role-based access controls.

  • An integration stopped working after I edited a key. Why? Changing the access level from read-and-write to read-only takes effect immediately. If the integration was relying on write access, it'll start failing on any requests that try to create, update, or delete data. Check the integration's error logs for 403 responses.

  • Can I tell which integration is using which key? The Description field is the only identifier — Level doesn't log which system made a given API request against a key. Use descriptive names at creation time so you can match keys to integrations later.

Hat dies deine Frage beantwortet?