> ## 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.

# Audit Logs API Übersicht

> Rufe eine Übersicht aller Aktionen in deinem Workspace ab — wer hat was, wann und von wo gemacht. Verfolge Änderungen an Workspace-Einstellungen, Model Keys, Integrationsverbindungen, Nutzerrollen und mehr.

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 Modellkonfiguration bis hin zu Workflows, Skill- und Aktionszugriff, 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. Erstelle ihn unter [Einstellungen > API](https://app.langdock.com/settings/workspace/products/api) in deinen Workspace-Einstellungen.

<Warning>
  **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.
</Warning>

## 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:

```bash theme={null}
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:

| Feld | Beschreibung |
| - | - |
| `actor_id`, `actor_type`, `actor_name` | Wer die Aktion ausgeführt hat. Akteur-Typen: `USER`, `API_KEY`, `SYSTEM`, `SCIM` |
| `action` | Was passiert ist, in Punkt-Notation (z.B. `user.updated`, `workspace.created`, `model_config.updated`, `workflow.created`, `api_keys.deleted`) |
| `entity_type`, `entity_id` | Welche Ressource betroffen war (z.B. `User`, `Workspace`, `Group`, `IntegrationConnection`, `ModelConfig`, `Workflow`, `SkillAccess`, `ActionAccess`) |
| `created_at` | Wann das Ereignis stattfand |
| `ip_address`, `user_agent` | Woher die Anfrage kam |
| `changes` | Ein `before`/`after`-Diff der geänderten Felder (bei Update-Ereignissen) |
| `snapshot` | Vollstä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.

```bash theme={null}
# 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:

| Parameter | Typ | Beschreibung |
| - | - | - |
| `from` | `datetime` | Beginn des Zeitraums (ISO 8601) |
| `to` | `datetime` | Ende des Zeitraums (ISO 8601) |
| `entity_type` | `string` | Nach Entity-Typ filtern (z.B. `User`, `Workspace`) |
| `actor_id` | `uuid` | Nach dem Akteur filtern, der die Aktion ausgeführt hat |
| `limit` | `integer` | Einträge pro Seite (Standard 50, Maximum 50) |
| `cursor` | `uuid` | Cursor aus der vorherigen Antwort für Pagination |

## Fehlerbehandlung

| Statuscode | Beschreibung |
| - | - |
| `400` | Ungültige Anfrageparameter (z.B. fehlerhaftes Datum, ungültige UUID) |
| `401` | Fehlender oder ungültiger API-Schlüssel |
| `403` | API-Schlüssel hat keinen `AUDIT_LOG_API` Scope, oder `workspace_id` stimmt nicht überein |
| `429` | Rate Limit überschritten — warte kurz und versuche es erneut |
| `500` | Interner Serverfehler |

<Info>
  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](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.