Zum Hauptinhalt springen
GET
/
api
/
audit-logs
/
{workspace_id}
List audit logs
curl --request GET \
  --url https://api.langdock.com/api/audit-logs/{workspace_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2026-02-09T14:30:00Z",
      "actor_id": "u1234567-89ab-cdef-0123-456789abcdef",
      "actor_type": "USER",
      "actor_name": "jane.doe@example.com",
      "action": "user.updated",
      "entity_type": "User",
      "entity_id": "u7654321-89ab-cdef-0123-456789abcdef",
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0",
      "changes": {
        "before": {
          "role": "MEMBER"
        },
        "after": {
          "role": "ADMIN"
        }
      },
      "snapshot": null
    }
  ],
  "next_cursor": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
⚠️ Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/public
Gibt Audit-Log-Einträge für einen Workspace mit cursor-basierter Pagination zurück. Jeder Eintrag dokumentiert eine Aktion im Workspace — wer sie ausgeführt hat, was sich geändert hat und wann. Verwende die Query-Parameter from und to, um ein Zeitfenster festzulegen, und den cursor-Parameter, um durch die Ergebnisse zu blättern.

Rate Limits

Das Rate Limit für den Audit Logs Endpunkt beträgt 500 RPM (Anfragen pro Minute). Rate Limits gelten auf Workspace-Ebene. Wenn du dein Rate Limit überschreitest, erhältst du eine 429 Too Many Requests-Antwort. Bitte beachte, dass sich die Rate Limits ändern können. Aktuelle Informationen findest du in dieser Dokumentation. Falls du ein höheres Rate Limit benötigst, kontaktiere uns unter support@langdock.com.
Weitere Informationen: Details zu Voraussetzungen, Pagination und Filtern findest du in der Einführung in die Audit Logs API.
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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

workspace_id
string<uuid>
erforderlich

Workspace UUID. Must match the workspace associated with the API key; requests with a mismatched workspace_id are rejected with 403.

Abfrageparameter

cursor
string<uuid>

Cursor for pagination (ID of last item from previous page)

limit
integer
Standard:50

Maximum number of items to return (default 50, max 50)

Erforderlicher Bereich: 1 <= x <= 50
from
string<date-time>

Start of date range filter (ISO 8601)

to
string<date-time>

End of date range filter (ISO 8601)

entity_type
string

Filter by entity type (e.g. "User", "Workspace")

actor_id
string<uuid>

Filter by actor UUID

Antwort

Paginated list of audit log entries

data
object[]
next_cursor
string<uuid> | null

Cursor for the next page, null if no more results