Sitzungstranskripte abrufen

Die Endpunkte auf dieser Seite stellen Compliance-Prüfern Transkripte der Sitzungen bereit, die deine Benutzer in Claude-Apps und -Agenten (derzeit: Cowork, Claude Code, Claude Science, Claude for Microsoft 365 und Claude in Chrome) in deinen Claude Enterprise-Organisationen ausführen. Jede Sitzung ist eine einzelne Unterhaltung mit Claude; ihr Transkript ist die Abfolge von Benutzer-Prompts, Assistentenantworten sowie Tool-Aufrufen und -Ergebnissen in dieser Unterhaltung. Die Endpunkte unterstützen eDiscovery-Exporte (electronic discovery) und die Durchsetzung von „data loss prevention" (Verhinderung von Datenverlust), oder DLP.

Die Compliance API gruppiert Sitzungen je nach Ausführungsort in zwei Endpunktfamilien: Endpunkte für lokale Sitzungen für Sitzungen auf den Rechnern der Benutzer und Endpunkte für Remote-Sitzungen für Sitzungen, die in der Cloud in von Anthropic verwalteten Umgebungen laufen. Beide Familien sind schreibgeschützt, und keine von beiden ist für Admin-API-Keys (sk-ant-admin01-...) verfügbar: Aufrufe, die mit einem Admin-API-Key authentifiziert werden, geben 403 Forbidden zurück.

Die folgende Tabelle ordnet jedes Produkt und seinen Ausführungsort der Endpunktfamilie zu, die seine Sitzungen zurückgibt, sowie dem product_surface-Wert, der sie in Antworten identifiziert. Produkte werden dieser Tabelle hinzugefügt, wenn die Abdeckung erweitert wird.

Die Erfassung lokaler Sitzungen ist daran gebunden, dass die Compliance API für deine Organisation aktiviert ist, und gilt, solange Benutzer mit ihrem Claude Enterprise-Konto angemeldet sind. Die Sitzungsendpunkte geben Folgendes nicht zurück:

• Claude Code-Sitzungen, die mit einem Claude Console-API-Key authentifiziert sind oder über eine Cloud-Plattform eines Drittanbieters wie Amazon Bedrock, Google Cloud oder Microsoft Foundry ausgeführt werden.
• Claude Code-Cloud-Sitzungen, die auf Cloud-Infrastruktur statt auf dem Rechner des Benutzers laufen. Diese Cloud-Sitzungen sind keine Remote-Sitzungen, obwohl beide in der Cloud laufen; die Endpunkte für Remote-Sitzungen geben nur Cowork-Sitzungen zurück.
• Lokale Sitzungen aus anderen Produkten als Cowork und Claude Code in Organisationen, in denen HIPAA-Bereitschaft aktiviert ist. In diesen Organisationen geben die Endpunkte für lokale Sitzungen nur Cowork- und Claude Code-Sitzungen zurück, und erfasste Sitzungsinhalte werden 30 Tage lang gespeichert.
• Lokale Sitzungen, für die „zero data retention" (Null-Datenaufbewahrung), oder ZDR, gilt. Diese Sitzungen sind von Listenergebnissen ausgeschlossen, und die Endpunkte zum Abrufen und für Nachrichten geben für sie 404 zurück.

Anthropic empfiehlt die Compliance API zum Abrufen von Sitzungsinhalten. Die folgende Tabelle vergleicht lokale Sitzungen und Remote-Sitzungen mit den OpenTelemetry-basierten Alternativen, die für Cowork und Claude Code verfügbar sind: OpenTelemetry-Logging von Cowork und Claude Code-Monitoring.

Sitzungen auf den Rechnern der Benutzer (lokale Sitzungen)

Lokale Sitzungen laufen auf den Rechnern der Benutzer, während diese mit ihrem Claude Enterprise-Konto angemeldet sind: derzeit Cowork in Claude Desktop, Claude Code (im Terminal, in Claude Desktop oder in einer IDE-Erweiterung), die Claude Science-Desktop-App, Claude for Microsoft 365 (in Excel, PowerPoint, Word und Outlook) und die Browsererweiterung Claude in Chrome.

Die Compliance API stellt lokale Sitzungen über drei Endpunkte bereit: GET /v1/compliance/apps/sessions/local listet Sitzungsmetadaten auf, GET /v1/compliance/apps/sessions/local/{session_id} ruft die Metadaten einer Sitzung ab, und GET /v1/compliance/apps/sessions/local/{session_id}/messages gibt das Transkript einer Sitzung zurück. Alle drei erfordern den Scope read:compliance_user_data und werden nur auf das gemeinsame „rate limit" (Ratenlimit) der Compliance API angerechnet; sie unterliegen nicht dem zweiten Anfragebudget, das für die Endpunkte für Remote-Sitzungen gilt. Siehe 429 Too Many Requests. Wenn lokale Sitzungen für deine übergeordnete Organisation nicht verfügbar sind, geben alle drei Endpunkte 404 mit der Meldung Local sessions are not available. zurück (siehe Lokale Sitzung nicht gefunden); solange Sitzungslisten oder erfasste Inhalte vorübergehend nicht verfügbar sind, geben sie 503 zurück (siehe Lokale Sitzungen vorübergehend nicht verfügbar).

Bei lokalen Sitzungen zeichnet Anthropic jede Unterhaltung serverseitig auf, sobald ihre Anfragen die Claude API erreichen; auf dem Gerät wird nichts installiert, und es wird nichts über die Anfragen hinaus erfasst, die der Client ohnehin an die Claude API sendet. Transkripte lokaler Sitzungen zeigen, worum Claude gebeten wurde und was es zurückgegeben hat, nicht, was auf dem Gerät geschehen ist. Datei- und Netzwerkaktivitäten sind nur über die Tool-Aufrufe und Tool-Ergebnisse im Transkript sichtbar, daher werden Aktivitäten, die die API nie erreichen (zum Beispiel lokale Dateien, die die Sitzung nie gesendet hat), nicht erfasst.

In Organisationen, die „customer-managed encryption keys" (kundenverwaltete Verschlüsselungsschlüssel) verwenden, werden Transkripte lokaler Sitzungen mit deinem kundenverwalteten Schlüssel verschlüsselt und wie gewohnt zurückgegeben. Solange dieser Schlüssel nicht verwendet werden kann (zum Beispiel, weil du ihn deaktiviert oder widerrufen hast oder weil er nicht erreichbar ist), gibt der Nachrichten-Endpunkt für die betroffenen Seiten 503 Service Unavailable statt Transkriptinhalten zurück. Diese Nachrichten werden nie als not_captured gemeldet (siehe Transkript einer lokalen Sitzung abrufen). Das Auflisten von Sitzungen und das Abrufen von Sitzungsmetadaten sind nicht betroffen.

Der Listen-Endpunkt gibt Sitzungsmetadaten ohne Transkriptinhalte für jede verknüpfte Organisation zurück, die dein Key lesen kann. Anders als die Liste der Remote-Sitzungen hat er keine Organisations- oder Benutzerfilter: Begrenze die Ergebnisse zeitlich mit den Parametern created_at.gte und created_at.lt. Beide akzeptieren RFC 3339-Zeitstempel mit einem erforderlichen UTC-Offset, und wenn beide angegeben werden, muss created_at.lt strikt nach created_at.gte liegen, andernfalls gibt die Anfrage 400 Bad Request zurück. Ein dritter Zeitfilter, updated_at.gte, begrenzt nach der letzten statt nach der ersten Aktivität: Er gibt Sitzungen zurück, deren letzter Inferenzaufruf zum angegebenen Zeitpunkt oder danach liegt, und lässt sich mit den created_at-Filtern kombinieren, ohne die Sortierung oder Paginierung zu ändern. Verwende ihn, um regelmäßig nach Sitzungen abzufragen, die seit einem vorherigen Durchlauf aktiv waren, wie weiter unten in diesem Abschnitt beschrieben. Neue Sitzungen und Nachrichten erscheinen nach einer kurzen Verarbeitungsverzögerung in den Ergebnissen, typischerweise innerhalb von Minuten; eine Sitzung, die unmittelbar nach ihrem Start fehlt, ist nicht unbedingt unerfasst. Die folgende Anfrage listet Sitzungen auf, die seit einem bestimmten Datum erstellt wurden.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/sessions/local" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data-urlencode "created_at.gte=2026-07-01T00:00:00Z" \
  --data-urlencode "limit=100"

{
  "data": [
    {
      "type": "compliance_local_session",
      "id": "clls_01HxKpLmNoPqRsTuVwXyZaBc",
      "organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
      "workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR",
      "user": {
        "id": "user_01GpKpLmNoPqRsTuVwXyZaBc",
        "email_address": "engineer@example.com"
      },
      "product_surface": "cowork",
      "created_at": "2026-07-09T14:02:11Z",
      "updated_at": "2026-07-09T14:02:38Z"
    },
    {
      "type": "compliance_local_session",
      "id": "clls_01HyLqMnOpQrStUvWxYzAbCd",
      "organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
      "workspace_id": null,
      "user": {
        "id": "user_01HqRsTuVwXyZaBcDeFgHiJk",
        "email_address": null
      },
      "product_surface": "claude_code",
      "created_at": "2026-07-08T09:15:43Z",
      "updated_at": "2026-07-08T09:52:10Z"
    }
  ],
  "next_page": "page_AAEfQx7mPdLkq9Rt2VwHbZk"
}

Die Ergebnisse sind in umgekehrt chronologischer Reihenfolge (neueste zuerst) nach created_at sortiert, wobei Gleichstände in einer festen serverseitigen Reihenfolge aufgelöst werden, und auf limit Ergebnisse pro Antwort begrenzt (Standard 100, maximal 500). Der Endpunkt paginiert nur vorwärts mit page- und next_page-Tokens (siehe Ergebnisse paginieren): Übergib den next_page-Wert der Antwort bei der nächsten Anfrage als Abfrageparameter page, und höre auf, wenn next_page null ist. Die Antwort hat kein Feld has_more. Schließe einen Listendurchlauf innerhalb von 24 Stunden nach seinem Start ab; ein älterer Listen-Cursor wird zwar weiterhin akzeptiert, aber anhand der aktuellen Aufbewahrungsgrenze neu ausgewertet, sodass Sitzungen, deren älteste aufbewahrte Aktivität kurz davor steht, aus dem Aufbewahrungszeitraum herauszufallen, übersprungen werden können.

In jedem Sitzungsobjekt ist user.id immer gesetzt und bleibt auch nach einer Kontolöschung erhalten; user.email_address ist null, wenn das Konto des Benutzers gelöscht wurde oder der Benutzer kein Mitglied einer Organisation mehr ist, die dein Key lesen kann. workspace_id ist null, wenn die Sitzung keinem Workspace zugeordnet war. Eine lokale Sitzung entspricht einer Client-Sitzungs-ID: Das Starten einer neuen Unterhaltung im Client oder das Leeren ihres Kontexts beginnt einen neuen Sitzungsdatensatz. Bei Claude Science kann die Liste auch separate Sitzungen für die eigene Hintergrundarbeit der App enthalten (zum Beispiel das Benennen der Unterhaltung; bei neueren App-Versionen auch ihre Reviewer- und Delegations-Tracks), und bei älteren App-Versionen erscheint ein Teil dieser Hintergrundarbeit als zusätzliche Nachrichten im eigenen Transkript der Unterhaltung. Eine Claude Science-Unterhaltung, die über bestimmte App-Updates hinweg fortgesetzt wird, erscheint als zwei Sitzungen. Diese Verhaltensweisen sind zu erwarten. Behandle id-Werte als undurchsichtige Zeichenfolgen; das Format kann sich ohne Vorankündigung ändern.

Bei Claude for Microsoft 365 erfolgt das Löschen einer Unterhaltung im Add-in nur auf dem Client und wird daher nicht in der API widergespiegelt: Lokale Sitzungen haben kein Feld deleted_at, und die Sitzung bleibt aufgelistet, bis die Aufbewahrung sie entfernt.

Lokale Sitzungen haben ein updated_at, aber keinen status: Eine lokale Sitzung hat keinen serverseitigen Lebenszyklusstatus, und ihre Sichtbarkeit wird stattdessen durch die Aufbewahrung bestimmt. Eine lokale Sitzung wird als die Reihe von Claude API-Aufrufen (Inferenzaufrufen) erfasst, die der Client während der Sitzung tätigt, und die Aufbewahrung gilt für jeden erfassten Aufruf einzeln. created_at ist der Zeitstempel des frühesten aufbewahrten Aufrufs der Sitzung und updated_at der Zeitstempel ihres letzten, beide in UTC. Wenn ältere Aufrufe den Aufbewahrungszeitraum überschreiten, rückt created_at entsprechend vor, und sobald jeder Aufruf in einer Sitzung herausgefallen ist, wird die Sitzung nicht mehr zurückgegeben; updated_at folgt dem jüngsten Aufruf und bleibt bis dahin unberührt. Da sich created_at zwischen Durchläufen verschieben kann, dedupliziere anhand von id, wenn du die Liste im Laufe der Zeit erneut durchläufst. Um Transkripte aktuell zu halten, während Sitzungen neue Nachrichten erhalten, frage regelmäßig mit dem Filter updated_at.gte ab und lasse aufeinanderfolgende Zeitfenster überlappen. Auf dem Listen-Endpunkt ist updated_at eine Untergrenze: Bei einer Sitzung, die an einer Seiten- oder created_at.lt-Fenstergrenze noch aktiv ist, kann der Wert kurzzeitig hinter der tatsächlichen letzten Aktivität der Sitzung zurückliegen, und ein neuer Aufruf wird erst nach der zuvor erwähnten kurzen Verarbeitungsverzögerung abfragbar. Setze wegen dieser Verzögerung das updated_at.gte jedes Durchlaufs einige Minuten vor die Startzeit deines vorherigen Durchlaufs, nicht genau auf die Zeit des vorherigen Durchlaufs. Eine Grenze, die genau auf die vorherige Zeit gesetzt ist, verwirft stillschweigend und dauerhaft eine Sitzung, deren letzter Aufruf zu diesem Zeitpunkt noch indiziert wurde, denn sobald die Grenze über diesen Aufruf hinaus vorrückt, gibt ihn kein späterer Durchlauf mehr zurück. Dedupliziere die zurückgegebenen Sitzungen anhand von id, rufe ihre Transkripte erneut ab und dedupliziere Nachrichten anhand von id. Das Abrufen einer Sitzung oder ihrer Nachrichten spiegelt immer genau den neuesten aufbewahrten Aufruf wider, daher ist ein regelmäßiger Abgleichsdurchlauf über ein älteres Zeitfenster eine gründlichere Alternative zum Vergrößern der Überlappung.

Die Liste wird aus Metadaten zur Sitzungsaktivität erstellt, daher kann sie Sitzungen enthalten, deren Transkriptinhalte nicht erfasst wurden, zum Beispiel Sitzungen, die liefen, bevor die Erfassung für deine Organisation begann (so weit zurück, wie dein Aufbewahrungszeitraum es zulässt); das Transkript einer solchen Sitzung gibt jede Nachricht mit als nicht verfügbar markiertem Inhalt zurück (siehe Transkript einer lokalen Sitzung abrufen).

Erfasste Inhalte lokaler Sitzungen werden standardmäßig 6 Jahre ab der Erfassung gespeichert. Wenn die Organisation, die die Sitzung ausgeführt hat, unter claude.ai > Organisationseinstellungen > Daten und Datenschutz einen endlichen benutzerdefinierten Aufbewahrungszeitraum für Unterhaltungen festgelegt hat, gilt stattdessen dieser Zeitraum, unabhängig davon, ob er kürzer oder länger als der Standard ist; wenn für die Organisation mehr als ein benutzerdefinierter Aufbewahrungszeitraum konfiguriert ist, gilt der kürzeste. Eine Änderung dieser Einstellung wirkt sich auf zwei verschiedene Arten aus: Die Endpunkte geben keine Aktivitäten mehr zurück, die älter als der aktuelle Zeitraum der Organisation sind, sobald sich die Einstellung ändert, während jede erfasste Nachricht für den Zeitraum gespeichert wird, der zum Zeitpunkt ihrer Erfassung galt, sodass eine spätere Verlängerung des Zeitraums bereits abgelaufene Inhalte nicht wiederherstellt. In Organisationen mit aktivierter HIPAA-Bereitschaft werden erfasste Inhalte lokaler Sitzungen 30 Tage ab der Erfassung gespeichert oder für den benutzerdefinierten Aufbewahrungszeitraum für Unterhaltungen der Organisation, wenn dieser kürzer ist; der 6-Jahres-Standard gilt nicht.

Um die Metadaten einer Sitzung direkt abzurufen, übergib ihre ID an GET /v1/compliance/apps/sessions/local/{session_id}. Die Antwort ist dasselbe Sitzungsobjekt, das der Listen-Endpunkt zurückgibt, ohne Umschlag und ohne Transkriptinhalte. Eine fehlerhafte Sitzungs-ID gibt 400 Bad Request zurück. Ein einziges 404 Not Found deckt vier Fälle ab, die die Antwort nicht unterscheidet: Die Sitzung befindet sich nicht in einer Organisation, die dein Key lesen kann (einschließlich Sitzungen unter einer anderen übergeordneten Organisation), sie existiert nicht, für sie gilt Zero Data Retention, oder jeder Aufruf darin hat den Aufbewahrungszeitraum überschritten.

product_surface (String oder null) identifiziert das Produkt, das die Sitzung erstellt hat: cowork (Cowork in Claude Desktop auf dem Rechner des Benutzers), claude_code (Claude Code), claude_science (Claude Science), claude_in_chrome (der integrierte Chat der Browsererweiterung Claude in Chrome) oder einer der Werte office_agents/excel, office_agents/powerpoint, office_agents/word und office_agents/outlook (Claude for Microsoft 365, nach App; nur office_agents, wenn die App nicht identifiziert wird). Neue Werte kommen hinzu, wenn die Abdeckung erweitert wird.

Transkript einer lokalen Sitzung abrufen

Der Nachrichten-Endpunkt gibt das Transkript der Sitzung zurück, rekonstruiert aus den erfassten Claude API-Aufrufen: Benutzer-Prompts, Assistententext, Tool-Aufrufe und die Textanteile von Tool-Ergebnissen, die abgesehen von Größenkürzungen alle so zurückgegeben werden, wie sie gesendet wurden. In diesen Inhalten werden weder URLs noch Anmeldedaten noch personenbezogene Daten maskiert, behandle Transkripte daher als sensibel. Das Transkript lässt Folgendes aus oder ersetzt es:

• Thinking-Blöcke sind nie enthalten.
• Der „system prompt" (System-Prompt) der Anfrage wird nie zurückgegeben. Eine Markierungsnachricht mit dem Text [system prompt content not shown] steht stellvertretend dafür (normalerweise einmal pro Sitzung; eine Sitzung ohne erfasste Inhalte enthält keine Markierung).
• Tool-Definitionen und die MCP-Serverkonfiguration sind nicht Teil des Transkripts.
• Bilder, PDFs und andere binäre oder strukturierte Blöcke werden nicht zurückgegeben. Jeder davon erscheint als text-Block mit dem Text [<block type> content not shown] (zum Beispiel [image content not shown]), bei dem truncated auf true gesetzt ist. Nicht-Text-Elemente innerhalb eines Tool-Ergebnisses, wie etwa Ergebnisse der Websuche oder die Ausgabe des Code-Ausführungstools, werden durch einen einzelnen Eintrag [N non-text item(s) not shown] ersetzt, und truncated des Tool-Ergebnisblocks ist true. Der zugehörige Tool-Aufruf mit der Suchanfrage oder dem Code in seinem input wird weiterhin zurückgegeben.
• Zitationsmetadaten in text-Blöcken, wie die Quellenangaben zu einer Antwort, die auf Websuchergebnissen basiert, werden ausgelassen. Der Text selbst wird zurückgegeben, und beim Block ist truncated auf true gesetzt.

Projektanweisungsdateien wie CLAUDE.md erscheinen als gewöhnliche Inhalte mit der Rolle „user". Skill-Inhalte erscheinen, wenn der Client sie als Nachrichteninhalt sendet, und werden nicht von anderem Benutzertext unterschieden. Eine Zusammenfassung der Abdeckung findest du in den Compliance API-FAQ; eine Tabelle, die lokale Sitzungen mit Remote-Sitzungen und dem OpenTelemetry-Logging vergleicht, findest du in der Einleitung dieser Seite.

session_id="clls_01HxKpLmNoPqRsTuVwXyZaBc"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/sessions/local/$session_id/messages" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

{
  "session": {
    "type": "compliance_local_session",
    "id": "clls_01HxKpLmNoPqRsTuVwXyZaBc",
    "organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
    "workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR",
    "user": {
      "id": "user_01GpKpLmNoPqRsTuVwXyZaBc",
      "email_address": null
    },
    "product_surface": "cowork",
    "created_at": "2026-07-09T14:02:11Z",
    "updated_at": "2026-07-09T14:02:38Z"
  },
  "data": [
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBa",
      "role": "user",
      "model": null,
      "created_at": "2026-07-09T14:02:11Z",
      "provenance": {
        "type": "synthetic_marker"
      },
      "content": [
        {
          "type": "text",
          "text": "[system prompt content not shown]",
          "truncated": true
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBc",
      "role": "user",
      "model": null,
      "created_at": "2026-07-09T14:02:11Z",
      "provenance": null,
      "content": [
        {
          "type": "text",
          "text": "Fix the failing test in tests/auth_test.py",
          "truncated": false
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBd",
      "role": "assistant",
      "model": "claude-opus-5-5",
      "created_at": "2026-07-09T14:02:11Z",
      "provenance": null,
      "content": [
        {
          "type": "text",
          "text": "I'll read the test file first.",
          "truncated": false
        },
        {
          "type": "tool_use",
          "id": "toolu_01AbCdEfGhIjKlMnOpQrSt",
          "name": "Read",
          "input": "{\"file_path\":\"tests/auth_test.py\"}",
          "truncated": false
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBe",
      "role": "user",
      "model": null,
      "created_at": "2026-07-09T14:02:38Z",
      "provenance": null,
      "content": [
        {
          "type": "tool_result",
          "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrSt",
          "name": "Read",
          "is_error": false,
          "content": [
            {
              "type": "text",
              "text": "def test_login_expiry():\n    ..."
            }
          ],
          "truncated": false
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBf",
      "role": "assistant",
      "model": "claude-opus-5-5",
      "created_at": "2026-07-09T14:02:38Z",
      "provenance": null,
      "content": [
        {
          "type": "text",
          "text": "The test was asserting on a stale expiry timestamp. I've updated it.",
          "truncated": false
        }
      ]
    }
  ],
  "next_page": null
}

Die Antwort enthält neben dem paginierten data-Array einen session-Umschlag. Der erste Datensatz in diesem Beispiel ist die Markierung, die stellvertretend für den System-Prompt der Anfrage steht; ihre provenance wird später in diesem Abschnitt beschrieben. Auf diesem Endpunkt ist user.email_address immer null: Der Nachrichten-Endpunkt löst keine E-Mail-Adressen auf, daher bedeutet ein null hier nicht, dass das Konto des Benutzers gelöscht wurde. Um eine Sitzung einer E-Mail-Adresse zuzuordnen, verknüpfe user.id mit dem Listen-Endpunkt oder dem Abruf-Endpunkt (GET /v1/compliance/apps/sessions/local/{session_id}).

Nachrichten werden standardmäßig mit der ältesten zuerst zurückgegeben; übergib order=desc, um die Reihenfolge umzukehren. Die Paginierung verwendet dasselbe page/next_page-Schema wie der Listen-Endpunkt, mit einem limit-Standardwert von 100 und einem Maximum von 1.000. Eine Seite kann vorzeitig enden, wenn die Antwort ihre Größenbegrenzung erreicht, daher bedeutet eine Seite mit weniger als limit Nachrichten nicht, dass du das Ende erreicht hast; paginiere weiter, bis next_page null ist. Seiten-Cursor sind an die Sitzung und die Sortierreihenfolge gebunden, unter denen sie ausgegeben wurden, und die Cursor eines Durchlaufs laufen 24 Stunden nach seiner ersten Seite ab: Ein abgelaufener Cursor gibt 400 Bad Request zurück und fordert dich auf, ohne den Parameter page neu zu beginnen, und der neu gestartete Durchlauf spiegelt die aktuelle Aufbewahrungsgrenze wider. Ein Cursor, der für eine andere Sitzung oder eine andere order ausgegeben wurde, gibt ebenfalls 400 als ungültiger Cursor zurück.

Jede Nachricht hat eine role (user oder assistant) und ein content-Array aus text-, tool_use- und tool_result-Blöcken. Sie hat außerdem ein model: Bei einem aus der Claude API erfassten „Turn" (Gesprächsrunde) des Assistenten ist dies das Modell, das den Turn bedient hat, und es ist null bei Benutzernachrichten und bei jeder Assistentennachricht, deren provenance gesetzt ist, da vom Client behauptete Verläufe und synthetische Markierungen nicht von einem Modell erzeugt wurden und das bedienende Modell für nicht verfügbare Inhalte unbekannt ist. Ein text-Block enthält text und truncated. Ein tool_use-Block enthält id, name, input und truncated, wobei input ein JSON-codierter String statt eines Objekts ist. Ein tool_result-Block enthält tool_use_id, name, is_error, ein content-Array aus text-Einträgen und truncated. MCP-Tool-Aufrufe und -Ergebnisse sowie die meisten Server-Tool-Aufrufe und -Ergebnisse werden in dieselben tool_use- und tool_result-Formen normalisiert; jeder andere Blocktyp erscheint als Platzhalter [<block type> content not shown]. Eine Nachrichten-id ist stabil, solange der Turn aufbewahrt wird. Jede Nachricht, die aus demselben Inferenzaufruf rekonstruiert wurde, trägt den Zeitstempel dieses Aufrufs, daher teilen aufeinanderfolgende Nachrichten oft denselben created_at-Wert; behalte die zurückgegebene Reihenfolge bei, statt nach Zeitstempel neu zu sortieren.

Jede Nachricht hat außerdem ein provenance-Feld, das beschreibt, wie ihr Inhalt erfasst wurde. provenance ist null für verifizierte Inhalte, die von der Claude API erfasst wurden, was der Normalfall ist. Andernfalls ist es ein Objekt, dessen type die Ausnahme kennzeichnet:

• content_unavailable bedeutet, dass der Inhalt nicht zurückgegeben werden kann. Das content-Array ist leer, und provenance.reason gibt den Grund an. not_captured bedeutet, dass für den Turn kein Inhalt verfügbar ist. Es beweist nicht, dass kein Datensatz gespeichert wurde: Inhalte, die die Datenverarbeitungsrichtlinien von Anthropic der Compliance API vorenthalten, werden mit demselben Grund gemeldet, ebenso einzelne Turns innerhalb einer ansonsten erfassten Sitzung, die aus solchen Gründen nicht verfügbar sind. Ein unbrauchbarer kundenverwalteter Schlüssel ist die einzige Ausnahme und gibt stattdessen 503 Service Unavailable zurück. client_aborted bedeutet, dass der Client die Verbindung geschlossen oder die Anfrage abgebrochen hat, bevor die Antwort vollständig war, sodass die Antwort des Turns nicht erfasst wurde; bereits an den Client gestreamte Teilausgaben sind nicht enthalten, und dieser Grund gilt nur für Turns mit der Rolle „assistant". cmek_key_revoked ist für Inhalte reserviert, die mit dem kundenverwalteten Schlüssel deiner Organisation verschlüsselt sind, wenn dieser Schlüssel nicht verfügbar ist (zum Beispiel widerrufen). Dieser Grund wird derzeit nicht zurückgegeben, da ein unbrauchbarer Schlüssel stattdessen einen 503 erzeugt, aber behandle ihn aus Gründen der Vorwärtskompatibilität. retention_elapsed bedeutet, dass der Inhalt den Aufbewahrungszeitraum überschritten hat. oversize bedeutet, dass eine einzelne Nachricht die Größengrenze pro Nachricht überschritten hat; die Nachricht wird dennoch zurückgegeben, mit einem leeren content-Array.
• client_asserted kennzeichnet Assistentennachrichten, die der Client als Unterhaltungsverlauf bereitgestellt hat und die keiner erfassten Antwort zugeordnet werden konnten; ihre Urheberschaft ist nicht verifiziert.
• synthetic_marker kennzeichnet Datensätze, die vom Endpunkt selbst erzeugt wurden, wie die Markierung, die stellvertretend für den System-Prompt steht. Wenn der Client seinen Unterhaltungsverlauf mitten in der Sitzung umschreibt oder komprimiert (zum Beispiel nach einer „context compaction" (Kontextkomprimierung)), fügt das Transkript an dieser Stelle eine Markierungsnachricht ein und fährt mit den neuen Inhalten fort, die der Client gesendet hat. Wenn deine Organisation einen endlichen Aufbewahrungszeitraum hat und diese neuen Inhalte Assistentennachrichten enthalten, hält das Transkript die neuen Inhalte bis einschließlich ihrer letzten Assistentennachricht zurück (eine zweite Markierung weist darauf hin) und zeigt nur die Benutzernachrichten nach diesem Punkt, gefolgt vom Rest der Sitzung.

Markierungsnachrichten und vom Client behauptete Nachrichten beginnen mit einem erklärenden text-Block in eckigen Klammern, der mit truncated: true gekennzeichnet ist, zum Beispiel [system prompt content not shown]. Behandle diese Datensätze als vorhanden, aber nicht verfügbar oder nicht verifiziert, statt als fehlend, und toleriere unbekannte provenance-Typen und -Gründe.

Zwei Parameter begrenzen, wie viele Bytes jedes Tool-Blocks zurückgegeben werden: tool_use_input_max_bytes und tool_result_max_bytes, beide mit einem Standardwert von 10.000 Bytes. Übergib -1 für das Servermaximum (etwa 1 MiB pro String); 0 gibt 400 Bad Request zurück, und Werte über dem Maximum werden darauf begrenzt. Ein String, der durch eine der beiden Grenzen gekürzt wird, wird an einer Zeichengrenze abgeschnitten und erhält ein angehängtes In-Band-Suffix (zum Beispiel …[truncated; pass tool_result_max_bytes=-1 for the server max]), und sein Block enthält "truncated": true. Ein gekürzter tool_use-input ist daher kein gültiges JSON mehr, parse Tool-Eingaben also nur aus ungekürzten Blöcken (oder erhöhe die Grenze und rufe erneut ab). Blöcke vom Typ text sind immer auf dasselbe Servermaximum von etwa 1 MiB begrenzt; kein Parameter erhöht es, und ein text-Block an der Grenze enthält ebenfalls "truncated": true.

Claude Science ruft Connectors (MCP-Server) aus Code auf, den es über sein repl-Tool ausführt, nicht als separat benannte Tools, daher ist kein Block in einem Claude Science-Transkript nach einem Connector benannt. Jeder Connector-Aufruf erscheint im Code innerhalb des input eines repl-tool_use-Blocks (zum Beispiel ein Aufruf host.mcp("<server>", "<tool>", ...)), und Connector-Ausgaben erscheinen im zugehörigen tool_result nur dort, wo dieser Code sie ausgegeben hat. Cowork- und Claude Code-Sitzungen unterscheiden sich davon: Sie rufen jedes Connector-Tool unter seinem eigenen Namen mcp__<server>__<tool> auf, der der name des tool_use-Blocks ist. Um die Connector-Nutzung in Claude Science-Sitzungen zu überwachen, parse den input-String und gleiche den darin enthaltenen Code ab, nicht einen Tool-Namen. Übergib für diese Sitzungen tool_use_input_max_bytes=-1, damit eine lange Code-Eingabe bis zum Servermaximum zurückgegeben wird, statt beim Standardwert von 10.000 Bytes abgeschnitten zu werden, bevor der Connector-Aufruf erscheint.

Transkriptinhalte berücksichtigen den unter Sitzungen auf den Rechnern der Benutzer beschriebenen Aufbewahrungszeitraum. Wenn der Anfang einer Sitzung diesen überschritten hat, beginnt das Transkript mit einem einzelnen content_unavailable-Platzhalter mit dem reason retention_elapsed, gefolgt von den aufbewahrten Nachrichten. Wenn alle Aufrufe einer Sitzung herausgefallen sind, gibt der Nachrichten-Endpunkt 404 Not Found zurück, wie bei Sitzungen in Organisationen, die dein Key nicht lesen kann, bei nicht existierenden Sitzungen und bei Sitzungen, für die Zero Data Retention gilt. Eine fehlerhafte Sitzungs-ID gibt 400 Bad Request zurück.

Sitzungen in der Cloud (Remote-Sitzungen)

Cowork-Sitzungen, die über claude.ai im Web oder auf Mobilgeräten gestartet werden, laufen in der Cloud in von Anthropic verwalteten Umgebungen. Die Compliance API stellt diese „remote sessions" (Remote-Sitzungen) über zwei Endpunkte bereit: GET /v1/compliance/apps/sessions/remote listet Sitzungsmetadaten auf, und GET /v1/compliance/apps/sessions/remote/{session_id}/messages gibt das Transkript einer Sitzung zurück. Beide erfordern den Scope read:compliance_user_data. Beide werden auf das gemeinsame „rate limit" (Ratenlimit) der Compliance API angerechnet und zusätzlich auf ein zweites Anfragebudget, das speziell für diese Endpunkte gilt; siehe 429 Too Many Requests.

Der Listen-Endpunkt gilt standardmäßig für die gesamte Organisation: Lass organization_ids[] weg, um jede claude.ai-Organisation einzuschließen, die dein Key lesen kann, oder übergib bis zu 500 Werte, um den Geltungsbereich einzugrenzen. Um die Liste stattdessen auf bestimmte Benutzer zu beschränken, übergib 1–10 user_ids[]-Werte (die IDs erhältst du über Organisationsbenutzer auflisten). Der Filter prüft den Benutzer, dem die Sitzung gehört. Daher werden Sitzungen im Besitz eines Agenten ausgeschlossen, sobald user_ids[] gesetzt ist. Begrenze die Ergebnisse zeitlich mit den created_at-Bereichsparametern (gte, gt, lt, lte, im RFC-3339-Format). Es gibt keinen updated_at-Filter. Die folgende Anfrage listet Sitzungen auf, die seit einem bestimmten Datum erstellt wurden.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/sessions/remote" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data-urlencode "created_at.gte=2026-06-01T00:00:00Z" \
  --data-urlencode "limit=100"

{
  "data": [
    {
      "id": "cse_01WpQrStUvXyZaBcDeFgHjK6",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "user@example.com"
      },
      "agent_id": null,
      "started_by_user": null,
      "status": "active",
      "created_at": "2026-07-01T17:04:05Z",
      "updated_at": "2026-07-01T18:00:41Z",
      "product_surface": "cowork_remote",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    },
    {
      "id": "cse_01TkNpRsUvWxYzAbCdEfGhJ4",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "user": null,
      "agent_id": "cagt_01MnPqRsTuVwXyZaBcDeFgH8",
      "started_by_user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "user@example.com"
      },
      "status": "archived",
      "created_at": "2026-06-28T09:15:22Z",
      "updated_at": "2026-06-28T09:47:10Z",
      "product_surface": "cowork_remote",
      "claude_project_id": null
    }
  ],
  "next_page": "page_AAEfMk93cXpYdGxrZXk"
}

Die Ergebnisse werden nach created_at in umgekehrt chronologischer Reihenfolge sortiert (neueste zuerst). Pro Antwort werden höchstens limit Ergebnisse zurückgegeben (Standard 100, Maximum 500). Der Endpunkt paginiert mit den Tokens page und next_page (siehe Ergebnisse paginieren): Übergib den next_page-Wert der Antwort bei der nächsten Anfrage als Query-Parameter page, und höre auf, sobald next_page den Wert null hat.

Eine Sitzung gehört entweder einem Benutzer oder einem Agenten, niemals beiden.

• Sitzungen im Besitz eines Benutzers: user enthält die ID und E-Mail-Adresse des Besitzers, und agent_id ist null. email_address ist null, wenn der Benutzer kein Mitglied einer Organisation mehr ist, die dein Key lesen kann. started_by_user ist null.
• Sitzungen im Besitz eines Agenten (zum Beispiel geplante Aufgaben): user ist null, und agent_id enthält die ID des Agenten (Präfix cagt_). started_by_user identifiziert die Person, die den Lauf ausgelöst hat, zum Beispiel durch das Starten einer geplanten Aufgabe.

claude_project_id ist die ID des claude.ai-Projekts, zu dem die Sitzung gehört (Präfix claude_proj_), oder null, wenn die Sitzung zu keinem Projekt gehört.

status ist einer der Werte pending, active, paused, archived oder failed. Eine Sitzung hat den Status pending, solange sie bereitgestellt wird. Eine pending-Sitzung hat noch kein Transkript, und der Nachrichten-Endpunkt gibt für sie 404 zurück, bis die Bereitstellung abgeschlossen ist. Gelöschte Sitzungen werden nie zurückgegeben.

product_surface (String oder null) gibt an, welches Produkt die Sitzung erstellt hat. Der Endpunkt gibt derzeit nur Sitzungen mit dem product_surface-Wert cowork_remote zurück, also Cowork-Sitzungen, die über claude.ai im Web oder auf Mobilgeräten gestartet wurden.

Transkript einer Remote-Sitzung abrufen

Der Nachrichten-Endpunkt gibt das Transkript der Sitzung zurück: Benutzer-Prompts, Antworten des Assistenten sowie Tool-Aufrufe und deren Ergebnisse. Thinking-Blöcke und Bilder sind nicht enthalten. Eine Übersicht über den Abdeckungsumfang findest du in den Compliance API FAQ. Eine Tabelle, die Remote-Sitzungen mit lokalen Sitzungen und dem OpenTelemetry-Logging von Cowork vergleicht, findest du in der Einleitung dieser Seite.

session_id="cse_01WpQrStUvXyZaBcDeFgHjK6"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/sessions/remote/$session_id/messages" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

{
  "session": {
    "id": "cse_01WpQrStUvXyZaBcDeFgHjK6",
    "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
    "user": {
      "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "email_address": null
    },
    "agent_id": null,
    "started_by_user": null,
    "status": "active",
    "created_at": "2026-07-01T17:04:05Z",
    "updated_at": "2026-07-01T18:00:41Z",
    "product_surface": "cowork_remote",
    "claude_project_id": null
  },
  "data": [
    {
      "id": "csev_01HjKmNpQrStUvWxYzAbCdE2",
      "role": "user",
      "created_at": "2026-07-01T17:04:05Z",
      "content": [
        {
          "type": "text",
          "text": "Summarize the customer feedback in the attached spreadsheet.",
          "truncated": false
        }
      ],
      "sent_by_user_id": null,
      "content_unavailable": false
    },
    {
      "id": "csev_01BcDeFgHjKmNpQrStUvWxY4",
      "role": "assistant",
      "created_at": "2026-07-01T17:04:06Z",
      "content": [
        {
          "type": "text",
          "text": "I'll start by reading the spreadsheet...",
          "truncated": false
        }
      ],
      "sent_by_user_id": null,
      "content_unavailable": false
    }
  ],
  "next_page": null
}

Die Antwort enthält neben dem paginierten data-Array einen session-Umschlag. Bei diesem Endpunkt sind user.email_address, started_by_user und claude_project_id im Umschlag immer auf null gesetzt. Diese Werte erhältst du stattdessen über den Listen-Endpunkt.

Nachrichten werden standardmäßig in chronologischer Reihenfolge zurückgegeben (älteste zuerst); übergib order=desc, um die Reihenfolge umzukehren. Die Paginierung verwendet dasselbe page/next_page-Schema wie der Listen-Endpunkt, mit einem limit-Standardwert von 100 und einem Maximum von 1.000. Eine Seite kann vorzeitig enden, wenn die Antwort ihre Größenbegrenzung erreicht. Eine Seite mit weniger als limit Nachrichten bedeutet also nicht, dass du das Ende erreicht hast. Paginiere weiter, bis next_page den Wert null hat.

Jede Nachricht enthält eine role (user oder assistant) und ein content-Array aus text-, tool_use- und tool_result-Blöcken.

• Reihenfolge: Die created_at-Werte von Nachrichten sind Commit-Zeitstempel. Aufeinanderfolgende Nachrichten können denselben Zeitstempel haben oder leicht vertauscht sein. Behalte daher die zurückgegebene Reihenfolge bei, statt nach created_at neu zu sortieren.
• Absender: Bei Sitzungen im Besitz eines Agenten gibt sent_by_user_id den Benutzer an, der eine bestimmte Benutzernachricht gesendet hat, sofern sich dieser zuordnen lässt. Andernfalls ist der Wert null, auch bei allen Assistentennachrichten.
• Nicht verfügbarer Inhalt: Wenn der Inhalt einer Nachricht überhaupt nicht zurückgegeben werden kann (zum Beispiel, weil er Größengrenzen überschreitet), ist bei der Nachricht content_unavailable auf true gesetzt.

Zwei Parameter begrenzen, wie viele Bytes jedes Tool-Blocks zurückgegeben werden: tool_use_input_max_bytes und tool_result_max_bytes, beide mit einem Standardwert von 10.000 Bytes. Übergib -1 für das Server-Maximum (etwa 1 MiB pro String); 0 führt zu 400 Bad Request. Ein Block, der durch eine dieser Grenzen abgeschnitten wurde, enthält "truncated": true. Eine abgeschnittene tool_use-Eingabe ist kein gültiges JSON mehr. Parse Tool-Eingaben daher nur aus nicht abgeschnittenen Blöcken (oder erhöhe die Grenze und rufe die Daten erneut ab).

Der Nachrichten-Endpunkt gibt 404 Not Found in folgenden Fällen zurück:

• für pending-Sitzungen
• für Sitzungen, die nicht existieren oder gelöscht wurden
• für Sitzungen in Organisationen, die dein Key nicht lesen kann

Aufbewahrung und Löschung

Die Sitzungs-Endpunkte sind schreibgeschützt; lokale und Remote-Sitzungen können nicht über die Compliance API gelöscht werden. Transkripte lokaler Sitzungen werden standardmäßig 6 Jahre lang aufbewahrt oder für den benutzerdefinierten Aufbewahrungszeitraum für Unterhaltungen deiner Organisation, sofern ein endlicher Zeitraum festgelegt ist, oder 30 Tage in Organisationen mit aktivierter HIPAA-Bereitschaft, wie unter Sitzungen auf den Rechnern der Benutzer beschrieben. Transkripte von Remote-Sitzungen werden 6 Jahre lang aufbewahrt, sofern ein Benutzer die Sitzung nicht früher löscht. Sobald ein Benutzer eine Sitzung löscht, geben die Endpunkte für Remote-Sitzungen sie nicht mehr zurück, und ihr Transkript kann über die Compliance API nicht wiederhergestellt werden. Wie sich diese Zeiträume zu den anderen Aufbewahrungsregelungen von Anthropic verhalten, erfährst du unter API und Datenaufbewahrung.

Nächste Schritte