--- title: Den Activity Feed abfragen url: https://platform.claude.com/docs/de/manage-claude/compliance-activity-feed description: Rufe den Compliance API Activity Feed deiner Organisation ab, filtere ihn und paginiere ihn. --- Wie du die Compliance API aktivierst, erfährst du unter [Compliance API einrichten](https://platform.claude.com/docs/de/manage-claude/compliance-api-access). **Erforderlicher Scope:** `read:compliance_activities` auf dem Compliance Access Key oder Admin-API-Key. Sowohl Compliance Access Keys (`sk-ant-api01-...`), die diesen Scope tragen, als auch Admin-API-Keys (`sk-ant-admin01-...`) können den Activity Feed aufrufen. Siehe [Die Compliance API einrichten](https://platform.claude.com/docs/de/manage-claude/compliance-api-access) für die Bedingungen, unter denen jeder Key-Typ den Scope trägt. Der Activity Feed (Aktivitätsfeed) zeichnet Authentifizierungs-, Chat-, Datei-, Projekt-, Verwaltungs- und Plattformaktivitäten in deiner gesamten Organisation auf und gibt sie in umgekehrt chronologischer Reihenfolge zurück. Aktivitäten sind innerhalb von 1 Minute nach ihrem Auftreten abfragbar und werden 6 Jahre lang aufbewahrt. Die Aufzeichnung erfolgt nicht rückwirkend: Sie beginnt, wenn die Compliance API erstmals für deine Organisation aktiviert wird, und Aktivitäten aus der Zeit vor der Aktivierung werden nicht nachträglich aufgefüllt. ```bash cURL curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/activities?limit=1" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` ```json Response { "data": [ { "id": "activity_01XyDMpzjS89pFZXqSFUBDr6", "created_at": "2026-04-10T08:09:10Z", "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8", "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789", "actor": { "type": "user_actor", "email_address": "user@example.com", "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4", "ip_address": "192.0.2.34", "user_agent": "Mozilla/5.0..." }, "type": "claude_chat_created", "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6", "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq" } ], "has_more": true, "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6", "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6" } ``` ## Aktivitäten filtern Filtere nach Organisation, Akteur, Aktivitätstyp oder einem `created_at`-Zeitfenster mithilfe der gepunkteten Unterparameter `created_at.gte`, `.gt`, `.lte` und `.lt`. Siehe die [API-Referenz](https://platform.claude.com/docs/de/api/compliance/activities/list) für den Typ und die akzeptierten Werte jedes Parameters. Wiederholbare Parameter verwenden die Array-Klammer-Query-Syntax: Übergib `activity_types[]=...`, `actor_ids[]=...` oder `organization_ids[]=...` einmal für jeden Wert. ```bash cURL curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/activities" \ --data-urlencode "activity_types[]=claude_file_uploaded" \ --data-urlencode "activity_types[]=claude_chat_created" \ --data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` Der Activity Feed erzeugt Hunderte verschiedener Aktivitätstypen. Siehe [Compliance-Aktivitäten abfragen](https://platform.claude.com/docs/de/api/compliance/activities/list) in der API-Referenz für die vollständige Liste der Werte, die `activity_types[]` akzeptiert. ## Ergebnisse paginieren Aktivitäten werden mit den neuesten zuerst zurückgegeben, wobei Gleichstände bei `created_at` durch die Aktivitäts-ID aufgelöst werden, und sind in jeder Antwort auf `limit` Ergebnisse begrenzt (Standard 100, maximal 5.000). Siehe die [API-Referenz](https://platform.claude.com/docs/de/api/compliance/activities/list) für das vollständige Antwortschema. Die Compliance API verwendet je nach Endpunktfamilie zwei Paginierungsschemata: | Endpunktfamilie | Sortierreihenfolge | Schema | Parameter | | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ | ---------- | ----------------------------------------------------------------- | | Aktivitäten | Neueste zuerst | Cursor | `after_id`, `before_id` (zurückgegeben als `first_id`, `last_id`) | | Chats und Chat-Nachrichten | Älteste zuerst | Cursor | `after_id`, `before_id` (zurückgegeben als `first_id`, `last_id`) | | Organisationen, Projekte, Projektanhänge, Benutzer, Rollen, Rollenberechtigungen, Gruppen, Gruppenmitglieder | Endpunktspezifisch | Page-Token | `page` (zurückgegeben als `next_page`) | | Lokale und Remote-Sitzungen sowie Sitzungsnachrichten | Sitzungen neueste zuerst; Nachrichten standardmäßig älteste zuerst | Page-Token | `page` (zurückgegeben als `next_page`) | Dateien werden nicht paginiert: Sie werden einzeln per ID abgerufen. Paginierungs-Cursor und Page-Tokens sind opake Zeichenketten: Gib sie unverändert zurück. Ihr internes Format ist nicht stabil, und das Parsen wird ohne Vorankündigung fehlschlagen. In jeder Anfrage darf nur einer der Parameter `after_id` oder `before_id` gesetzt sein, und beide Schemata geben `has_more` zurück, damit du weißt, wann du aufhören musst. Die Sitzungsendpunkte (lokal und remote) sind die Ausnahme: Sie geben `next_page` ohne `has_more` zurück, höre also auf, wenn `next_page` `null` ist. Um durch Aktivitäten zu blättern: * Übergib das `last_id` der Antwort als `after_id`, um zur nächsten Seite in Ergebnisreihenfolge zu gelangen. Da Aktivitäten mit den neuesten zuerst sortiert sind, enthält die nächste Seite ältere Einträge. * Übergib `first_id` als `before_id`, um zur vorherigen Seite zurückzukehren. * Höre auf, wenn `has_more` `false` ist. Der Cursor-Parameter legt die Seitenrichtung fest; die Sortierreihenfolge des Endpunkts legt die Zeitrichtung fest. Derselbe `after_id`-Parameter erreicht hier ältere Aktivitäten. Chats werden mit den ältesten zuerst sortiert; siehe [Chats, Dateien und Projekte abrufen und löschen](https://platform.claude.com/docs/de/manage-claude/compliance-content-data) für die dortige Cursor-Semantik. **Cursor können bei Wiederholungsversuchen sicher wiederverwendet werden.** Ein Cursor oder Page-Token von einer erfolgreich zurückgegebenen Seite bleibt gültig; eine fehlgeschlagene Anfrage (5xx, Timeout, Netzwerkfehler) verschiebt deine Position nicht. Wiederhole dieselbe Anfrage mit demselben Cursor. Gehe erst zum nächsten Cursor über, nachdem du die Seite gespeichert hast, über die er hinauszeigt. Page-Tokens auf den lokalen Sitzungsendpunkten sind bei längeren Pausen die Ausnahme. Auf dem [Endpunkt für lokale Sitzungsnachrichten](https://platform.claude.com/docs/de/manage-claude/compliance-sessions#retrieve-a-local-session-transcript) laufen die `page`-Tokens eines Durchlaufs 24 Stunden nach seiner ersten Seite ab (ein Durchlauf ist ein Durchgang durch die Seiten), schließe ihn also innerhalb dieses Zeitfensters ab oder setze ihn fort, oder starte ohne den `page`-Parameter neu. Auf der [Liste lokaler Sitzungen](https://platform.claude.com/docs/de/manage-claude/compliance-sessions#retrieve-local-sessions) wird ein älteres `page`-Token weiterhin akzeptiert, aber gegen die aktuelle Aufbewahrungsgrenze neu ausgewertet und kann Sitzungen überspringen, schließe also auch Listendurchläufe innerhalb von 24 Stunden ab. ```bash cURL # Rufe die erste Seite ab (neueste Aktivitäten zuerst) und speichere ihren abschließenden Cursor. last_id=$(curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/activities?limit=2" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" | jq -er '.last_id') # Gib den Cursor unverändert zurück, um die nächste (ältere) Seite abzurufen. curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/activities" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" \ --data-urlencode "limit=2" \ --data-urlencode "after_id=${last_id}" ``` Eine produktive **Backfill**-Schleife blättert durch ältere Aktivitäten, indem sie die Iteration über `has_more` und `last_id` steuert: 1. Beginne bei deinem gespeicherten Cursor (oder lasse `after_id` weg, um am Anfang zu beginnen). 2. Blättere mit `after_id=` weiter, bis `has_more` `false` ist. 3. Persistiere das letzte `last_id` erst, nachdem du jede Seite gespeichert hast, die es abdeckt. ```text cursor = stored_cursor loop: if cursor is not null: page = GET /v1/compliance/activities?after_id={cursor}&limit=100 else: page = GET /v1/compliance/activities?limit=100 store(page.data) if page.last_id is not null: cursor = page.last_id if not page.has_more: break persist(cursor) ``` ## Das Activity-Objekt verstehen Jeder Eintrag in `data` ist eine Activity mit dieser Struktur auf oberster Ebene: | Feld | Typ | Beschreibung | | -------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | Eindeutiger Bezeichner für die Aktivität. | | `created_at` | RFC-3339-String | Wann die Aktivität stattgefunden hat. | | `organization_id` | string oder null | Organisation, in der die Aktivität stattgefunden hat, oder `null` für Ereignisse, die nicht an eine Organisation gebunden sind (Anmeldung, Abmeldung, Compliance-API-Aufrufe). | | `organization_uuid` | string oder null | Gleicher Geltungsbereich wie `organization_id`, ausgedrückt als UUID. | | `actor` | Actor-Union | Wer oder was die Aktivität ausgeführt hat. Siehe die folgende Akteur-Tabelle. | | `type` | string | Der Aktivitätstyp, zum Beispiel `claude_chat_created`. | | *zusätzliche Felder* | variiert | Typspezifische Felder, zum Beispiel `claude_chat_id` bei Chat-Ereignissen oder `claude_file_id` bei Datei-Ereignissen. Die Feldliste pro Typ findest du unter [Compliance-Aktivitäten abfragen](https://platform.claude.com/docs/de/api/compliance/activities/list) in der API-Referenz. | Das Feld `actor` ist eine diskriminierte Union. Der Diskriminator `type` gibt an, welche anderen Felder vorhanden sind: | `actor.type` | Wann er auftritt | Wichtige Felder | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user_actor` | Ein angemeldeter claude.ai- oder Claude Console-Benutzer hat die Aktion ausgeführt, oder ein Prozess, den Anthropic im Namen dieses Benutzers ausführt (siehe den Absatz nach dieser Tabelle). | `email_address`, `user_id`, `ip_address`, `user_agent` | | `api_actor` | Eine Anfrage hat die Claude API oder die Compliance API mit einem vom Kunden ausgestellten API-Key aufgerufen. Compliance-API-Aufrufe erzeugen diesen Akteurtyp sowohl für Compliance Access Keys als auch für Admin-API-Keys. | `api_key_id`, `ip_address`, `user_agent` | | `admin_api_key_actor` | Ein Organisationsadministrator hat einen Admin-API-Key verwendet, um Benutzer, Einladungen, Workspaces oder API-Keys zu verwalten. | `admin_api_key_id`, `ip_address`, `user_agent` | | `unauthenticated_user_actor` | Eine Aktion fand statt, bevor die Anmeldung abgeschlossen war, zum Beispiel `sso_login_initiated`. | `unauthenticated_email_address`, `ip_address`, `user_agent` | | `anthropic_actor` | Anthropic hat in der Organisation gehandelt, zum Beispiel über interne Tools. | `email_address` (immer `null`; aus Gründen der Strukturkonsistenz mit `user_actor` vorhanden, da Anthropic-Mitarbeiter nicht durch individuelle E-Mail-Adressen repräsentiert werden) | | `system_actor` | Automatisierte Hintergrundverarbeitung durch Anthropic-Systeme, die ohne Benutzer- oder Kundenanmeldedaten erfolgt. | `service` (nullable; der Name des automatisierten Prozesses, der die Aktion ausgeführt hat, sofern bekannt) | | `scim_directory_sync_actor` | Ein Identitätsanbieter (wie Okta, Microsoft Entra ID oder JumpCloud) hat eine Änderung über die SCIM-Verzeichnissynchronisierung übertragen. | `workos_event_id`, `directory_id`, `idp_connection_type` (nullable; zum Beispiel `OktaSCIMV2`, `AzureSCIMV2`) | Eine `user_actor`-Aktivität bedeutet nicht immer, dass der Benutzer die Aktion ausgeführt hat. Prozesse, die Anthropic im Namen eines Benutzers ausführt, können derzeit als `user_actor` für den betroffenen Benutzer statt als `system_actor` erscheinen, und diese Zuordnung kann sich ändern. Beispielsweise werden Memory-Aktivitäten aus einer Migration, wie `platform_memory_store_created`, `platform_memory_created` und `platform_memory_deleted`, auf diese Weise zugeordnet. Memory-Aktivitäten können unabhängig davon, wer sie ausgeführt hat, eine `ip_address` von `0.0.0.0` aufweisen, sodass dieser Wert allein keine Aktivität eines Plattformprozesses identifiziert. Eine `claude_*_viewed`-Aktivität bedeutet, dass eine Claude-App Inhalte geladen hat, nicht, dass eine Person sie angesehen hat. Typen wie `claude_chat_viewed`, `claude_file_viewed` und `claude_project_viewed` werden jedes Mal aufgezeichnet, wenn eine Claude-App den Chat, die Datei oder das Projekt von den Servern von Anthropic lädt. Wiederholte Ladevorgänge werden nicht dedupliziert. Die Web-, Desktop- und Mobil-Apps laden Inhalte zu unterschiedlichen Zeitpunkten, manchmal im Hintergrund, und können eine zwischengespeicherte Kopie anzeigen, ohne sie zu laden. Die Anzahl dieser Aktivitäten variiert daher je nach Plattform, und sie entspricht nicht den gesendeten Nachrichten oder angesehenen Bildschirmen. Aktivitäten zu Dateien, Projektdokumenten oder Artifacts enthalten deren Namen oder Titel nicht. Ab dem 24. September 2026 sind die Felder `filename` und `title` bei diesen Aktivitäten immer `null`, ein leerer String oder nicht vorhanden, auch bei Aktivitäten, die vor diesem Datum aufgezeichnet wurden. Um einen Namen oder Titel nachzuschlagen, übergib die `claude_file_*`-, `claude_proj_doc_*`- oder `claude_artifact_version_*`-ID der Aktivität an den passenden Metadaten-Endpunkt unter [Dateien und Artifacts abrufen](https://platform.claude.com/docs/de/manage-claude/compliance-content-data#retrieve-files-and-artifacts) und verwende dabei einen Compliance Access Key mit dem Scope `read:compliance_user_data`. Du kannst keinen Namen oder Titel nachschlagen, nachdem die Datei, das Dokument oder das Artifact gelöscht wurde, oder wenn die Aktivität keine solche ID hat. **Erstelle vorwärtskompatible Handler.** Reiche unbekannte `type`- und `actor.type`-Werte durch und ignoriere Felder, die dein Handler nicht erwartet, damit deine Integration weiter funktioniert, wenn neue Aktivitätstypen ausgeliefert werden. ## Nächste Schritte Das vollständige Anfrage- und Antwortschema für `GET /v1/compliance/activities`, einschließlich aller unterstützten `activity_types[]`-Werte. Frage die zugrunde liegenden Inhalte für Aktivitäten, die du im Feed findest, ab und lösche sie (Compliance Access Key erforderlich). Wähle ein Polling- oder Batch-Verarbeitungsmuster und plane die SIEM-Korrelation. Der vollständige Fehlerkatalog.