Récupérer les transcriptions de sessions

Les points de terminaison de cette page exposent aux responsables de la conformité les transcriptions des sessions que vos utilisateurs exécutent dans les applications et agents Claude (aujourd'hui : Cowork, Claude Code, Claude Science, Claude for Microsoft 365 et Claude in Chrome) depuis vos organisations Claude Enterprise. Chaque session est une conversation unique avec Claude ; sa transcription est la séquence des prompts utilisateur, des réponses de l'assistant, ainsi que des appels d'outils et de leurs résultats dans cette conversation. Ces points de terminaison prennent en charge les exports d'« eDiscovery » (découverte électronique) et l'application de la « data loss prevention » (prévention des pertes de données), ou DLP.

La Compliance API regroupe les sessions en deux familles de points de terminaison selon l'endroit où elles s'exécutent : les points de terminaison des sessions locales pour les sessions sur les machines des utilisateurs, et les points de terminaison des sessions distantes pour les sessions qui s'exécutent dans le cloud, dans des environnements gérés par Anthropic. Les deux familles sont en lecture seule, et aucune n'est accessible aux clés Admin API (sk-ant-admin01-...) : les appels authentifiés avec une clé Admin API renvoient 403 Forbidden.

Le tableau suivant associe chaque produit, et l'endroit où il s'exécute, à la famille de points de terminaison qui renvoie ses sessions et à la valeur product_surface qui les identifie dans les réponses. Des produits sont ajoutés à ce tableau à mesure que la couverture s'étend.

La capture des sessions locales est liée à l'activation de la Compliance API pour votre organisation et s'applique tant que les utilisateurs sont connectés avec leur compte Claude Enterprise. Les points de terminaison des sessions ne renvoient pas les éléments suivants :

• Les sessions Claude Code authentifiées avec une clé API Claude Console, ou exécutées via une plateforme cloud tierce telle qu'Amazon Bedrock, Google Cloud ou Microsoft Foundry.
• Les sessions cloud Claude Code, qui s'exécutent sur une infrastructure cloud plutôt que sur la machine de l'utilisateur. Ces sessions cloud ne sont pas des sessions distantes, même si les deux s'exécutent dans le cloud ; les points de terminaison des sessions distantes renvoient uniquement les sessions Cowork.
• Les sessions locales des produits autres que Cowork et Claude Code dans les organisations où la préparation HIPAA est activée. Dans ces organisations, les points de terminaison des sessions locales renvoient uniquement les sessions Cowork et Claude Code, et le contenu capturé des sessions est conservé pendant 30 jours.
• Les sessions locales pour lesquelles la « zero data retention » (conservation zéro des données), ou ZDR, est en vigueur. Ces sessions sont exclues des résultats de liste, et les points de terminaison de récupération et de messages renvoient 404 pour elles.

Anthropic recommande la Compliance API pour récupérer le contenu des sessions. Le tableau suivant compare les sessions locales et les sessions distantes avec les alternatives basées sur OpenTelemetry disponibles pour Cowork et Claude Code : la journalisation OpenTelemetry de Cowork et la surveillance de Claude Code.

Sessions sur les machines des utilisateurs (sessions locales)

Les sessions locales s'exécutent sur les machines des utilisateurs lorsqu'ils sont connectés avec leur compte Claude Enterprise : actuellement, Cowork dans Claude Desktop, Claude Code (dans le terminal, dans Claude Desktop ou dans une extension d'IDE), l'application de bureau Claude Science, Claude for Microsoft 365 (dans Excel, PowerPoint, Word et Outlook) et l'extension de navigateur Claude in Chrome.

La Compliance API expose les sessions locales via trois points de terminaison : GET /v1/compliance/apps/sessions/local liste les métadonnées des sessions, GET /v1/compliance/apps/sessions/local/{session_id} récupère les métadonnées d'une session, et GET /v1/compliance/apps/sessions/local/{session_id}/messages renvoie la transcription d'une session. Les trois nécessitent la portée read:compliance_user_data et ne sont décomptés que de la « rate limit » (limite de débit) partagée de la Compliance API ; ils ne sont pas soumis au second budget de requêtes qui s'applique aux points de terminaison des sessions distantes. Consultez 429 Too Many Requests. Si les sessions locales ne sont pas disponibles pour votre organisation parente, les trois points de terminaison renvoient 404 avec le message Local sessions are not available. (consultez Session locale introuvable) ; lorsque les listes de sessions ou le contenu capturé sont temporairement indisponibles, ils renvoient 503 (consultez Sessions locales temporairement indisponibles).

Pour les sessions locales, Anthropic enregistre chaque conversation côté serveur à mesure que ses requêtes atteignent l'API Claude ; rien n'est installé sur l'appareil, et rien n'est collecté au-delà des requêtes que le client envoie déjà à l'API Claude. Les transcriptions des sessions locales montrent ce qu'il a été demandé à Claude de faire et ce qu'il a renvoyé, et non ce qui s'est passé sur l'appareil. L'activité sur les fichiers et le réseau n'est visible qu'à travers les appels d'outils et les résultats d'outils de la transcription, de sorte que l'activité qui n'atteint jamais l'API (par exemple, les fichiers locaux que la session n'a jamais envoyés) n'est pas capturée.

Dans les organisations qui utilisent des « customer-managed encryption keys » (clés de chiffrement gérées par le client), les transcriptions des sessions locales sont chiffrées avec votre clé gérée par le client et renvoyées normalement. Tant que cette clé ne peut pas être utilisée (par exemple, parce que vous l'avez désactivée ou révoquée, ou parce qu'elle est inaccessible), le point de terminaison des messages renvoie 503 Service Unavailable pour les pages concernées au lieu du contenu de la transcription. Ces messages ne sont jamais signalés comme not_captured (consultez Récupérer la transcription d'une session locale). Le listage des sessions et la récupération des métadonnées de session ne sont pas affectés.

Le point de terminaison de liste renvoie les métadonnées des sessions, sans contenu de transcription, pour chaque organisation liée que votre clé peut lire. Contrairement à la liste des sessions distantes, il ne dispose d'aucun filtre par organisation ou par utilisateur : délimitez les résultats dans le temps avec les paramètres created_at.gte et created_at.lt. Tous deux acceptent des horodatages RFC 3339 avec un décalage UTC obligatoire, et lorsque les deux sont fournis, created_at.lt doit être strictement postérieur à created_at.gte, sans quoi la requête renvoie 400 Bad Request. Un troisième filtre temporel, updated_at.gte, délimite selon la dernière activité plutôt que la première : il renvoie les sessions dont le dernier appel d'inférence a eu lieu à l'heure indiquée ou après, et se combine avec les filtres created_at sans modifier l'ordre ni la pagination. Utilisez-le pour interroger périodiquement les sessions actives depuis un passage précédent, comme décrit plus loin dans cette section. Les nouvelles sessions et les nouveaux messages apparaissent dans les résultats après un court délai de traitement, généralement de quelques minutes ; une session absente immédiatement après son démarrage n'est pas nécessairement non capturée. La requête suivante liste les sessions créées depuis une date donnée.

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"
}

Les résultats sont triés par ordre chronologique inverse (les plus récents en premier) selon created_at, les égalités étant départagées selon un ordre fixe côté serveur, et plafonnés à limit résultats par réponse (100 par défaut, 500 au maximum). Le point de terminaison pagine uniquement vers l'avant avec les jetons page et next_page (consultez Paginer les résultats) : renvoyez la valeur next_page de la réponse comme paramètre de requête page lors de la requête suivante, et arrêtez-vous lorsque next_page vaut null. La réponse ne comporte pas de champ has_more. Terminez le parcours d'une liste dans les 24 heures suivant son début ; un curseur de liste plus ancien est toujours accepté, mais il est réévalué par rapport à la limite de conservation actuelle, de sorte que les sessions dont l'activité conservée la plus ancienne est sur le point de dépasser la période de conservation peuvent être ignorées.

Dans chaque objet session, user.id est toujours défini et persiste après la suppression du compte ; user.email_address vaut null lorsque le compte de l'utilisateur a été supprimé ou que l'utilisateur n'est plus membre d'une organisation que votre clé peut lire. workspace_id vaut null lorsque la session n'était associée à aucun espace de travail. Une session locale correspond à un identifiant de session client : démarrer une nouvelle conversation dans le client, ou effacer son contexte, crée un nouvel enregistrement de session. Pour Claude Science, la liste peut également inclure des sessions distinctes pour le travail en arrière-plan propre à l'application (par exemple, le nommage de la conversation ; sur les versions plus récentes de l'application, également ses pistes de relecture et de délégation), et sur les versions plus anciennes de l'application, une partie de ce travail en arrière-plan apparaît sous forme de messages supplémentaires dans la transcription de la conversation elle-même. Une conversation Claude Science qui se poursuit à travers certaines mises à jour de l'application apparaît sous forme de deux sessions. Ces comportements sont attendus. Traitez les valeurs id comme des chaînes opaques ; leur format peut changer sans préavis.

Pour Claude for Microsoft 365, la suppression d'une conversation dans le complément n'a lieu que côté client, elle n'est donc pas reflétée dans l'API : les sessions locales n'ont pas de champ deleted_at, et la session reste listée jusqu'à ce que la conservation la supprime.

Les sessions locales comportent un updated_at mais pas de status : une session locale n'a pas de statut de cycle de vie côté serveur, et sa visibilité est régie par la conservation. Une session locale est capturée sous la forme de la série d'appels à l'API Claude (appels d'inférence) que le client effectue pendant la session, et la conservation s'applique individuellement à chaque appel capturé. created_at est l'horodatage de l'appel conservé le plus ancien de la session et updated_at celui de son dernier appel, tous deux en UTC. À mesure que les appels plus anciens dépassent la période de conservation, created_at avance en conséquence, et une fois que tous les appels d'une session ont expiré, la session n'est plus renvoyée ; updated_at suit l'appel le plus récent et n'est pas affecté jusque-là. Comme created_at peut changer d'une exécution à l'autre, dédupliquez sur id lorsque vous parcourez à nouveau la liste au fil du temps. Pour maintenir les transcriptions à jour à mesure que les sessions reçoivent de nouveaux messages, interrogez périodiquement avec le filtre updated_at.gte, en faisant se chevaucher les fenêtres consécutives. Sur le point de terminaison de liste, updated_at est une borne inférieure : pour une session encore active à la limite d'une page ou d'une fenêtre created_at.lt, il peut momentanément être en retard sur la véritable dernière activité de la session, et un nouvel appel ne devient interrogeable qu'après le court délai de traitement mentionné précédemment. En raison de ce décalage, définissez le updated_at.gte de chaque exécution quelques minutes avant l'heure de début de votre exécution précédente, et non exactement à l'heure de l'exécution précédente. Une borne définie exactement à l'heure précédente écarte silencieusement et définitivement une session dont le dernier appel était encore en cours d'indexation à ce moment-là, car une fois que la borne a dépassé cet appel, aucune exécution ultérieure ne le renvoie. Dédupliquez les sessions renvoyées sur id, récupérez à nouveau leurs transcriptions et dédupliquez les messages sur id. La récupération d'une session, ou de ses messages, reflète toujours exactement le dernier appel conservé ; un passage de réconciliation périodique sur une fenêtre plus ancienne constitue donc une alternative plus rigoureuse à l'élargissement du chevauchement.

La liste est construite à partir des métadonnées d'activité des sessions ; elle peut donc inclure des sessions dont le contenu de transcription n'a pas été capturé, par exemple des sessions exécutées avant le début de la capture pour votre organisation (aussi loin que votre période de conservation le permet) ; la transcription d'une telle session renvoie chaque message avec son contenu marqué comme indisponible (consultez Récupérer la transcription d'une session locale).

Le contenu capturé des sessions locales est conservé pendant 6 ans à compter de la capture par défaut. Si l'organisation qui a exécuté la session a défini une période de conservation personnalisée finie des conversations dans claude.ai > Paramètres de l'organisation > Données et confidentialité, c'est cette période qui s'applique, qu'elle soit plus courte ou plus longue que la valeur par défaut ; lorsque l'organisation a configuré plusieurs périodes de conservation personnalisées, la plus courte s'applique. Une modification de ce paramètre prend effet de deux manières différentes : les points de terminaison cessent de renvoyer l'activité antérieure à la période actuelle de l'organisation dès que le paramètre change, tandis que chaque message capturé est conservé pendant la période en vigueur au moment de sa capture, de sorte qu'allonger la période ultérieurement ne restaure pas le contenu déjà expiré. Dans les organisations où la préparation HIPAA est activée, le contenu capturé des sessions locales est conservé pendant 30 jours à compter de la capture, ou pendant la période de conservation personnalisée des conversations de l'organisation lorsque celle-ci est plus courte ; la valeur par défaut de 6 ans ne s'applique pas.

Pour récupérer directement les métadonnées d'une session, transmettez son identifiant à GET /v1/compliance/apps/sessions/local/{session_id}. La réponse est le même objet session que celui renvoyé par le point de terminaison de liste, sans enveloppe et sans contenu de transcription. Un identifiant de session mal formé renvoie 400 Bad Request. Une seule réponse 404 Not Found couvre quatre cas que la réponse ne distingue pas : la session n'appartient pas à une organisation que votre clé peut lire (y compris les sessions relevant d'une autre organisation parente), elle n'existe pas, la conservation zéro des données est en vigueur pour elle, ou tous ses appels ont dépassé la période de conservation.

product_surface (chaîne ou null) identifie le produit qui a créé la session : cowork (Cowork dans Claude Desktop sur la machine de l'utilisateur), claude_code (Claude Code), claude_science (Claude Science), claude_in_chrome (le chat intégré de l'extension de navigateur Claude in Chrome), ou l'une des valeurs office_agents/excel, office_agents/powerpoint, office_agents/word et office_agents/outlook (Claude for Microsoft 365, par application ; office_agents seul lorsque l'application n'est pas identifiée). De nouvelles valeurs apparaissent à mesure que la prise en charge s'étend.

Récupérer la transcription d'une session locale

Le point de terminaison des messages renvoie la transcription de la session, reconstruite à partir des appels à l'API Claude capturés : prompts de l'utilisateur, texte de l'assistant, appels d'outils et parties textuelles des résultats d'outils, tous renvoyés tels qu'ils ont été envoyés, à l'exception de la troncature liée à la taille. Rien ne masque les URL, les identifiants de connexion ou les données personnelles dans ce contenu ; traitez donc les transcriptions comme des données sensibles. La transcription omet ou remplace les éléments suivants :

• Les blocs de réflexion ne sont jamais inclus.
• Le « system prompt » (invite système) de la requête n'est jamais renvoyé. Un message marqueur indiquant [system prompt content not shown] le remplace (normalement une fois par session ; une session sans contenu capturé ne comporte aucun marqueur).
• Les définitions d'outils et la configuration des serveurs « Model Context Protocol », ou MCP, ne font pas partie de la transcription.
• Les images, les PDF et les autres blocs binaires ou structurés ne sont pas renvoyés. Chacun apparaît sous la forme d'un bloc text indiquant [<block type> content not shown] (par exemple, [image content not shown]) avec truncated défini sur true. Les éléments non textuels à l'intérieur d'un résultat d'outil, tels que les résultats de recherche web ou la sortie de l'outil d'exécution de code, sont remplacés par une seule entrée [N non-text item(s) not shown], et le champ truncated du bloc de résultat d'outil vaut true. L'appel d'outil correspondant, avec la requête de recherche ou le code dans son input, est toujours renvoyé.
• Les métadonnées de citation des blocs text, telles que les citations de sources d'une réponse qui s'appuie sur des résultats de recherche web, sont omises. Le texte lui-même est renvoyé, et le bloc comporte truncated défini sur true.

Les fichiers d'instructions de projet tels que CLAUDE.md apparaissent comme du contenu ordinaire de rôle utilisateur. Le contenu des Skills apparaît lorsque le client l'envoie comme contenu de message et n'est pas distingué du reste du texte de l'utilisateur. Pour un résumé de la couverture, consultez la FAQ de la Compliance API ; pour un tableau comparant les sessions locales aux sessions distantes et à la journalisation OpenTelemetry, consultez l'introduction de cette page.

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
}

La réponse intègre une enveloppe session à côté du tableau paginé data. Le premier enregistrement de cet exemple est le marqueur qui remplace l'invite système de la requête ; son champ provenance est décrit plus loin dans cette section. Sur ce point de terminaison, user.email_address vaut toujours null : le point de terminaison des messages ne résout pas les adresses e-mail, donc un null ici ne signifie pas que le compte de l'utilisateur a été supprimé. Pour attribuer une session à une adresse e-mail, faites une jointure sur user.id avec le point de terminaison de liste ou le point de terminaison de récupération (GET /v1/compliance/apps/sessions/local/{session_id}).

Les messages sont renvoyés du plus ancien au plus récent par défaut ; transmettez order=desc pour inverser l'ordre. La pagination utilise le même schéma page/next_page que le point de terminaison de liste, avec une valeur limit de 100 par défaut et de 1 000 au maximum. Une page peut se terminer prématurément lorsque la réponse atteint sa limite de taille ; une page contenant moins de limit messages ne signifie donc pas que vous avez atteint la fin ; continuez à paginer jusqu'à ce que next_page vaille null. Les curseurs de page sont liés à la session et à l'ordre de tri sous lesquels ils ont été émis, et les curseurs d'un parcours expirent 24 heures après sa première page : un curseur expiré renvoie 400 Bad Request en vous indiquant de recommencer sans le paramètre page, et le parcours relancé reflète la limite de conservation actuelle. Un curseur émis pour une autre session ou un autre order renvoie également 400, en tant que curseur invalide.

Chaque message comporte un role (user ou assistant) et un tableau content de blocs text, tool_use et tool_result. Il comporte également un champ model : pour un tour de l'assistant capturé depuis l'API Claude, il s'agit du modèle qui a servi ce tour, et il vaut null pour les messages de l'utilisateur et pour tout message de l'assistant dont le champ provenance est défini, car l'historique déclaré par le client et les marqueurs synthétiques n'ont pas été produits par un modèle, et le modèle ayant servi est inconnu pour le contenu indisponible. Un bloc text comporte text et truncated. Un bloc tool_use comporte id, name, input et truncated, où input est une chaîne encodée en JSON plutôt qu'un objet. Un bloc tool_result comporte tool_use_id, name, is_error, un tableau content d'entrées text, et truncated. Les appels et résultats d'outils MCP, ainsi que la plupart des appels et résultats d'outils serveur, sont normalisés dans ces mêmes formes tool_use et tool_result ; tout autre type de bloc apparaît sous la forme d'un espace réservé [<block type> content not shown]. L'id d'un message est stable tant que le tour est conservé. Chaque message reconstruit à partir du même appel d'inférence porte l'horodatage de cet appel, de sorte que des messages consécutifs partagent souvent la même valeur created_at ; conservez l'ordre renvoyé plutôt que de trier à nouveau par horodatage.

Chaque message comporte également un champ provenance décrivant la manière dont son contenu a été capturé. provenance vaut null pour le contenu vérifié capturé par l'API Claude, ce qui est le cas le plus courant. Sinon, il s'agit d'un objet dont le champ type signale l'exception :

• content_unavailable signifie que le contenu ne peut pas être renvoyé. Le tableau content est vide, et provenance.reason en indique la raison. not_captured signifie qu'aucun contenu n'est disponible pour le tour. Cela ne prouve pas qu'aucun enregistrement n'a été stocké : le contenu que les politiques de traitement des données d'Anthropic excluent de la Compliance API est signalé avec la même raison, tout comme les tours individuels, au sein d'une session par ailleurs capturée, qui sont indisponibles pour de telles raisons. Une clé gérée par le client inutilisable constitue la seule exception et renvoie 503 Service Unavailable à la place. client_aborted signifie que le client a fermé la connexion ou annulé la requête avant la fin de la réponse, de sorte que la réponse du tour n'a pas été capturée ; toute sortie partielle déjà envoyée en streaming au client n'est pas incluse, et cette raison s'applique uniquement aux tours de rôle assistant. cmek_key_revoked est réservé au contenu chiffré avec la clé gérée par le client de votre organisation lorsque cette clé est indisponible (par exemple, révoquée). Cette raison n'est pas renvoyée actuellement, car une clé inutilisable produit une erreur 503 à la place, mais gérez-la pour assurer la compatibilité future. retention_elapsed signifie que le contenu a dépassé la période de conservation. oversize signifie qu'un message individuel a dépassé la limite de taille par message ; le message est tout de même renvoyé, avec un tableau content vide.
• client_asserted signale les messages de l'assistant que le client a fournis comme historique de conversation et qui n'ont pas pu être associés à une réponse capturée ; leur auteur n'est pas vérifié.
• synthetic_marker signale les enregistrements générés par le point de terminaison lui-même, comme le marqueur qui remplace l'invite système. Lorsque le client réécrit ou compacte son historique de conversation en cours de session (par exemple, après une compaction du contexte), la transcription insère un message marqueur à cet endroit et se poursuit avec le nouveau contenu envoyé par le client. Lorsque votre organisation dispose d'une période de conservation finie et que ce nouveau contenu inclut des messages de l'assistant, la transcription masque le nouveau contenu jusqu'à son dernier message de l'assistant inclus (un second marqueur le signale) et n'affiche que les messages de l'utilisateur postérieurs à ce point, suivis du reste de la session.

Les messages marqueurs et les messages déclarés par le client commencent par un bloc text explicatif entre crochets marqué truncated: true, par exemple [system prompt content not shown]. Traitez ces enregistrements comme présents mais indisponibles ou non vérifiés plutôt que comme manquants, et tolérez les types et raisons provenance non reconnus.

Deux paramètres plafonnent le nombre d'octets renvoyés pour chaque bloc d'outil : tool_use_input_max_bytes et tool_result_max_bytes, tous deux fixés par défaut à 10 000 octets. Transmettez -1 pour obtenir le maximum du serveur (environ 1 Mio par chaîne) ; 0 renvoie 400 Bad Request, et les valeurs supérieures au maximum sont ramenées à celui-ci. Une chaîne coupée par l'un ou l'autre plafond est coupée à une limite de caractère et se voit ajouter un suffixe intégré (par exemple, …[truncated; pass tool_result_max_bytes=-1 for the server max]), et son bloc comporte "truncated": true. Un input de tool_use tronqué n'est donc plus du JSON valide ; n'analysez donc les entrées d'outils qu'à partir de blocs non tronqués (ou augmentez le plafond et récupérez-les à nouveau). Les blocs de type text sont toujours plafonnés au même maximum du serveur d'environ 1 Mio ; aucun paramètre ne permet de l'augmenter, et un bloc text atteignant cette limite comporte également "truncated": true.

Claude Science appelle les connecteurs (serveurs MCP) depuis du code qu'il exécute via son outil repl, et non en tant qu'outils nommés séparément ; aucun bloc d'une transcription Claude Science ne porte donc le nom d'un connecteur. Chaque appel de connecteur apparaît dans le code à l'intérieur de l'input d'un bloc tool_use nommé repl (par exemple, un appel host.mcp("<server>", "<tool>", ...)), et la sortie du connecteur n'apparaît dans le tool_result correspondant que là où ce code l'a affichée. Les sessions Cowork et Claude Code diffèrent : elles appellent chaque outil de connecteur sous son propre nom mcp__<server>__<tool>, qui est le name du bloc tool_use. Pour surveiller l'utilisation des connecteurs dans les sessions Claude Science, analysez la chaîne input et appliquez vos critères de correspondance au code qu'elle contient plutôt qu'à un nom d'outil. Transmettez tool_use_input_max_bytes=-1 pour ces sessions afin qu'une longue entrée de code soit renvoyée jusqu'au maximum du serveur au lieu d'être coupée à la valeur par défaut de 10 000 octets avant que l'appel de connecteur n'apparaisse.

Le contenu des transcriptions respecte la période de conservation décrite dans Sessions sur les machines des utilisateurs. Lorsque le début d'une session a dépassé cette période, la transcription commence par un unique espace réservé content_unavailable avec une reason valant retention_elapsed, suivi des messages conservés. Lorsque tous les appels d'une session ont expiré, le point de terminaison des messages renvoie 404 Not Found, comme il le fait pour les sessions des organisations que votre clé ne peut pas lire, les sessions qui n'existent pas et les sessions pour lesquelles la conservation zéro des données est en vigueur. Un identifiant de session mal formé renvoie 400 Bad Request.

Sessions dans le cloud (sessions distantes)

Les sessions Cowork démarrées sur claude.ai web ou mobile s'exécutent dans le cloud, dans des environnements gérés par Anthropic. La Compliance API expose ces « remote sessions » (sessions distantes) via deux points de terminaison : GET /v1/compliance/apps/sessions/remote liste les métadonnées des sessions, et GET /v1/compliance/apps/sessions/remote/{session_id}/messages renvoie la transcription d'une session. Les deux nécessitent la portée read:compliance_user_data. Chaque requête est décomptée de la « rate limit » (limite de débit) partagée de la Compliance API, ainsi que d'un second budget de requêtes propre à ces points de terminaison ; consultez 429 Too Many Requests.

Par défaut, le point de terminaison de liste couvre toute l'organisation. Omettez organization_ids[] pour inclure toutes les organisations claude.ai que votre clé peut lire, ou transmettez jusqu'à 500 valeurs pour restreindre la portée. Pour limiter plutôt la liste à des utilisateurs spécifiques, transmettez de 1 à 10 valeurs user_ids[] (obtenez les identifiants via Lister les utilisateurs de l'organisation). Ce filtre porte sur l'utilisateur propriétaire de la session : les sessions appartenant à un agent sont donc exclues dès que user_ids[] est défini. Bornez les résultats dans le temps avec les paramètres de plage created_at (gte, gt, lt, lte, au format RFC 3339). Il n'existe pas de filtre updated_at. La requête suivante liste les sessions créées depuis une date donnée.

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"
}

Les résultats sont triés par created_at dans l'ordre chronologique inverse (les plus récents en premier). Chaque réponse contient au plus limit résultats (100 par défaut, 500 au maximum). Le point de terminaison pagine à l'aide des jetons page et next_page (consultez Paginer les résultats). Renvoyez la valeur next_page de la réponse comme paramètre de requête page lors de la requête suivante, et arrêtez-vous lorsque next_page vaut null.

Une session appartient soit à un utilisateur, soit à un agent, jamais aux deux.

• Pour les sessions appartenant à un utilisateur, user contient l'identifiant et l'adresse e-mail du propriétaire, et agent_id vaut null. email_address vaut null lorsque l'utilisateur n'est plus membre d'une organisation que votre clé peut lire.
• Pour les sessions appartenant à un agent (par exemple, les tâches planifiées), user vaut null et agent_id contient l'identifiant de l'agent (préfixe cagt_). started_by_user identifie la personne qui a lancé l'exécution, par exemple en démarrant une tâche planifiée.

Sur les sessions appartenant à un utilisateur, started_by_user vaut null.

claude_project_id est l'identifiant du projet claude.ai auquel appartient la session (préfixe claude_proj_), ou null lorsque la session ne fait pas partie d'un projet.

status prend l'une des valeurs pending, active, paused, archived ou failed. Une session est pending pendant son provisionnement. Une session pending n'a pas encore de transcription, et le point de terminaison des messages renvoie une erreur 404 pour celle-ci jusqu'à la fin du provisionnement. Les sessions supprimées ne sont jamais renvoyées.

product_surface (chaîne ou null) identifie le produit qui a créé la session. Le point de terminaison ne renvoie actuellement que les sessions dont product_surface vaut cowork_remote, c'est-à-dire les sessions Cowork démarrées sur claude.ai web ou mobile.

Récupérer la transcription d'une session distante

Le point de terminaison des messages renvoie la transcription de la session : les prompts de l'utilisateur, les réponses de l'assistant, ainsi que les « tool calls » (appels d'outils) et leurs résultats. Les blocs de réflexion et les images ne sont pas inclus. Pour un résumé de la couverture des données, consultez la FAQ de la Compliance API. L'introduction de cette page contient un tableau qui compare les sessions distantes, les sessions locales et la journalisation OpenTelemetry de Cowork.

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
}

La réponse intègre une enveloppe session à côté du tableau paginé data. Sur ce point de terminaison, user.email_address, started_by_user et claude_project_id valent toujours null dans l'enveloppe. Obtenez plutôt ces valeurs à partir du point de terminaison de liste.

Par défaut, les messages sont renvoyés du plus ancien au plus récent ; transmettez order=desc pour inverser l'ordre. La pagination utilise le même mécanisme page/next_page que le point de terminaison de liste. limit vaut 100 par défaut, avec un maximum de 1 000. Une page peut se terminer prématurément lorsque la réponse atteint sa taille limite. Une page contenant moins de limit messages ne signifie donc pas que vous avez atteint la fin : continuez à paginer jusqu'à ce que next_page vaille null.

Chaque message comporte un role (user ou assistant) et un tableau content composé de blocs text, tool_use et tool_result.

• Horodatages : les valeurs created_at des messages sont des horodatages de validation. Des messages consécutifs peuvent partager le même horodatage ou être légèrement inversés. Conservez donc l'ordre renvoyé plutôt que de trier à nouveau par created_at.
• Expéditeur : sur les sessions appartenant à un agent, sent_by_user_id enregistre l'utilisateur qui a envoyé un message utilisateur donné, lorsque celui-ci peut être attribué. Sinon, ce champ vaut null, y compris sur tous les messages de l'assistant.
• Contenu indisponible : lorsque le contenu d'un message ne peut pas être renvoyé du tout (par exemple, s'il dépasse les limites de taille), le message comporte content_unavailable défini sur true.

Deux paramètres plafonnent le nombre d'octets renvoyés pour chaque bloc d'outil : tool_use_input_max_bytes et tool_result_max_bytes. Tous deux valent 10 000 octets par défaut. Transmettez -1 pour obtenir le maximum du serveur (environ 1 Mio par chaîne) ; 0 renvoie 400 Bad Request. Un bloc tronqué par l'un ou l'autre de ces plafonds comporte "truncated": true. Une entrée tool_use tronquée n'est plus du JSON valide : n'analysez donc les entrées d'outils qu'à partir de blocs non tronqués, ou augmentez le plafond et récupérez à nouveau les données.

Le point de terminaison des messages renvoie 404 Not Found dans les cas suivants :

• les sessions pending ;
• les sessions qui n'existent pas ou qui ont été supprimées ;
• les sessions appartenant à des organisations que votre clé ne peut pas lire.

Conservation et suppression

Les points de terminaison des sessions sont en lecture seule : les sessions locales et distantes ne peuvent pas être supprimées via la Compliance API. Les transcriptions des sessions locales sont conservées pendant 6 ans par défaut, ou pendant la durée de conservation des conversations personnalisée de votre organisation lorsqu'une durée finie est définie, ou pendant 30 jours dans les organisations où la préparation HIPAA est activée, comme décrit dans Sessions sur les machines des utilisateurs. Les transcriptions des sessions distantes sont conservées pendant 6 ans, sauf si un utilisateur supprime la session plus tôt. Les points de terminaison des sessions distantes ne renvoient plus une session une fois qu'un utilisateur l'a supprimée, et sa transcription ne peut pas être récupérée via la Compliance API. Pour savoir comment ces durées s'articulent avec les autres dispositions de conservation d'Anthropic, consultez API et conservation des données.

Étapes suivantes