Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.langdock.com/llms.txt

Use this file to discover all available pages before exploring further.

Die Audit Logs API kann verwendet werden, um:
  • Workspace-Aktivitätsdaten in dein SIEM oder andere Monitoring-Tools einzuspeisen
  • Änderungen in deiner Organisation nachzuverfolgen, von Workspace-Einstellungen und Model Keys bis hin zu Rollenänderungen, fehlgeschlagenen Anmeldeversuchen und mehr
  • Eigene Dashboards und Berichte für Workspace-Aktivitäten zu erstellen

​
Voraussetzungen

Um die Audit Logs API zu nutzen, benötigst du:
  • Workspace Admin-Berechtigung: Nur Workspace-Administratoren können API-Schlüssel mit Audit-Log-Berechtigungen erstellen.
  • API-Schlüssel mit AUDIT_LOG_API Scope: Dein API-Schlüssel muss den dedizierten Audit-Log Scope aktiviert haben.
Wichtiger Sicherheitshinweis: Nutzer mit Zugriff auf einen API-Schlüssel mit dem AUDIT_LOG_API Scope können alle Audit-Log-Daten des Workspaces einsehen, einschließlich IP-Adressen, Nutzeraktionen und Konfigurationsänderungen. Gewähre diese Berechtigung nur vertrauenswürdigen Nutzern.

​
Aufbewahrung

Audit-Log-Einträge werden 90 Tage lang aufbewahrt. Stelle sicher, dass du alle benötigten Daten exportierst oder weiterleitest, bevor sie ablaufen.

​
Verfügbarer Endpunkt

GET /audit-logs/{workspace_id}

​
Authentifizierung

Alle API-Anfragen erfordern Bearer-Token-Authentifizierung: 
Authorization: Bearer YOUR_API_KEY

​
Der Audit-Log-Eintrag

Jeder Audit-Log-Eintrag beschreibt einen Akteur, der eine Aktion auf einer Entität ausführt. Hier ist, was jeder Eintrag enthält:
FeldBeschreibung
actor_id, actor_type, actor_nameWer die Aktion ausgeführt hat. Akteur-Typen: USER, API_KEY, SYSTEM, SCIM
actionWas passiert ist, in Punkt-Notation (z.B. user.updated, workspace.created, api_keys.deleted)
entity_type, entity_idWelche Ressource betroffen war (z.B. User, Workspace, Group, IntegrationConnection)
created_atWann das Ereignis stattfand
ip_address, user_agentWoher die Anfrage kam
changesEin before/after-Diff der geänderten Felder (bei Update-Ereignissen)
snapshotVollständiger Entity-Snapshot oder zusätzliche Event-Metadaten (z.B. bei Delete-/Create-Ereignissen oder zusätzlicher Kontext wie fehlgeschlagene Login-Details)

​
Pagination

Die API verwendet cursor-basierte Pagination. Jede Antwort enthält ein next_cursor-Feld — übergib es als cursor-Query-Parameter in deiner nächsten Anfrage, um die nächste Seite zu erhalten. Wenn next_cursor null ist, hast du das Ende erreicht. 
# Erste Anfrage
curl "https://api.langdock.com/audit-logs/{workspace_id}?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Nächste Seite
curl "https://api.langdock.com/audit-logs/{workspace_id}?limit=50&cursor={next_cursor}" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Filtern

Du kannst Ergebnisse mit Query-Parametern eingrenzen:
ParameterTypBeschreibung
fromdatetimeBeginn des Zeitraums (ISO 8601)
todatetimeEnde des Zeitraums (ISO 8601)
entity_typestringNach Entity-Typ filtern (z.B. User, Workspace)
actor_iduuidNach dem Akteur filtern, der die Aktion ausgeführt hat
limitintegerEinträge pro Seite (Standard 50, Maximum 50)
cursoruuidCursor aus der vorherigen Antwort für Pagination

​
Fehlerbehandlung

StatuscodeBeschreibung
400Ungültige Anfrageparameter (z.B. fehlerhaftes Datum, ungültige UUID)
401Fehlender oder ungültiger API-Schlüssel
403API-Schlüssel hat keinen AUDIT_LOG_API Scope, oder workspace_id stimmt nicht überein
429Rate Limit überschritten — warte kurz und versuche es erneut
500Interner Serverfehler
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.