For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/de/getting-started/api-keys.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
API-Schlüssel
API-Schlüssel sind programmatische Zugangsdaten für das Voice-Logica-API — jeder Schlüssel ist auf die Operationen beschränkt, die Sie erlauben, und kann auf eine einzelne IP-Adresse begrenzt werden. Derselbe Schlüssel meldet auch MCP-Clients (ChatGPT, Claude) an Ihrem Workspace an. Die Schlüssel finden Sie unter Team and access → API Keys.
Einen API-Schlüssel erstellen
Abschnitt betitelt „Einen API-Schlüssel erstellen“-
Öffnen Sie die Registerkarte API Keys
Gehen Sie zu Team and access in der Account-Gruppe der Seitennavigation, wählen Sie die Registerkarte API Keys und klicken Sie auf “Api Key”.

api-keys-0 -
Schlüssel benennen und IP einschränken
Vergeben Sie einen aussagekräftigen Namen, der den Zweck widerspiegelt — “CRM Integration”, “Webhook Handler”, “Initiate Call”. Optional tragen Sie eine IP-Adresse ein, um Aufrufe auf eine Adresse zu beschränken; leer lassen erlaubt jede IP.

api-keys-1 -
Erlaubte Operationen wählen
Unter API operation restrictions schalten Sie frei, welche Operationen der Schlüssel aufrufen darf. Die Operationen sind nach Bereichen gruppiert — Calls, Agents, VoIP & SIP, SMS, Workflows, MCP, Billing und Shopify. Lassen Sie alles aktiviert für Vollzugriff oder deaktivieren Sie, was der Schlüssel nicht braucht.

api-keys-2 -
Erstellen und Schlüssel kopieren
Klicken Sie auf “Create API Key”. Der vollständige Schlüsselwert wird nur dieses eine Mal angezeigt — kopieren Sie ihn jetzt und bewahren Sie ihn sicher auf.

api-keys-3
Schlüssel verwalten
Abschnitt betitelt „Schlüssel verwalten“Die API-Keys-Tabelle zeigt jeden Schlüssel mit Name, dem maskierten Schlüssel, zuletzt verwendet und erstellt am.

- Bearbeiten — Name, IP-Beschränkung und erlaubte Operationen aktualisieren. Der Schlüsselwert selbst wird nicht erneut angezeigt und lässt sich nicht ändern.
- Löschen — entfernt den Schlüssel dauerhaft. Das lässt sich nicht rückgängig machen; jede Anwendung, die ihn nutzt, verliert sofort den Zugriff.
Ihren API-Schlüssel verwenden
Abschnitt betitelt „Ihren API-Schlüssel verwenden“Authentifizieren Sie Anfragen, indem Sie den Schlüssel im Header x-api-key senden:
x-api-key: YOUR_API_KEYZum Beispiel einen ausgehenden AI-Anruf starten:
curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "destinationNumber": "+302101234567", "agentId": "your-agent-id", "voipPhoneId": "your-voip-phone-id" }'destinationNumber ist erforderlich; übergeben Sie agentId für ausgehende AI-Anrufe und entweder voipPhoneId oder sipTrunkId, um die ausgehende Leitung zu wählen. Die vollständige interaktive Referenz aller Endpunkte finden Sie unter api.voicelogica.ai/api-docs.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“Warum liefern meine API-Anfragen den Fehler 401 Unauthorized?
Senden Sie den API-Schlüssel im Header x-api-key, nicht als Bearer-Token. Prüfen Sie außerdem, dass der Schlüssel nicht aus der Tabelle API Keys gelöscht wurde. Hat der Schlüssel eine IP-Beschränkung, muss die Anfrage genau von dieser Adresse kommen.
Warum liefern meine API-Anfragen den Fehler 403 Forbidden?
Die Operationsbeschränkungen des API-Schlüssels enthalten den aufgerufenen Endpunkt nicht. Bearbeiten Sie den Schlüssel und aktivieren Sie die passende Operationsgruppe.
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“Brauchen Sie Hilfe?
Abschnitt betitelt „Brauchen Sie Hilfe?“Bei Problemen ist das Voice-Logica-Support-Team für Sie da:
