Récupérer et supprimer des conversations, des fichiers et des projets

Les points de terminaison de cette page exposent le contenu des conversations claude.ai, les fichiers téléversés, les projets et les pièces jointes de projets aux réviseurs de conformité. Ils prennent en charge les exports d'« eDiscovery » (découverte électronique), l'application de la « data loss prevention » (prévention des pertes de données), ou DLP, et les réponses aux demandes de suppression de compte. Le contenu est conservé aussi longtemps que la politique de rétention de votre organisation le permet. Les conversations qu'un utilisateur a supprimées de manière réversible dans claude.ai restent visibles via l'API de conformité avec le champ deleted_at renseigné ; les conversations qui ont été supprimées définitivement (via l'API de conformité elle-même, ou après l'expiration de la fenêtre de rétention de l'organisation) ne sont pas récupérables.

Les deux portées ne sont accordées que sur les clés d'accès de conformité (sk-ant-api01-...) créées dans claude.ai ; consultez Obtenir l'accès à l'API de conformité pour en provisionner une. La portée read:compliance_user_data couvre la récupération ; delete:compliance_user_data n'est requise que pour les points de terminaison de suppression. Les points de terminaison de conversations, fichiers, projets et pièces jointes ne sont pas disponibles pour les clés API d'administration (sk-ant-admin01-...) ; les appels authentifiés avec une clé API d'administration renvoient 403 Forbidden.

Les points de terminaison de cette page paginent de deux manières ; consultez Paginer les résultats pour la référence complète. Chaque section indique quel schéma s'applique.

Récupérer des conversations et des messages

Utilisez Lister les conversations pour parcourir les métadonnées des conversations, puis Obtenir les messages d'une conversation pour récupérer le contenu complet des messages d'une conversation.

Le point de terminaison de liste des conversations nécessite au moins une valeur user_ids[] (et en accepte jusqu'à 10 dans une seule requête) ; énumérez donc d'abord les ID utilisateur avec Lister les utilisateurs de l'organisation, puis listez les conversations pour chaque utilisateur ou pour chaque lot d'utilisateurs. La requête suivante liste les conversations appartenant à un utilisateur spécifique depuis une date donnée.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/chats" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "user_ids[]=user_01XyDMpzjS89pFZXqSFUBDr6" \
  --data-urlencode "organization_ids[]=91012d09-e48b-438e-a489-1bebfd8fa6f9" \
  --data-urlencode "created_at.gte=2025-06-01T00:00:00Z" \
  --data-urlencode "limit=100"

{
  "data": [
    {
      "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
      "name": "Product Requirements Discussion",
      "created_at": "2026-04-10T08:09:10Z",
      "updated_at": "2026-04-10T09:10:11Z",
      "deleted_at": null,
      "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789",
      "model": "claude-opus-4-8",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
      "user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "[email protected]"
      }
    }
  ],
  "has_more": true,
  "first_id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "last_id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja"
}

La liste des conversations ne renvoie que des métadonnées. Consultez Lister les conversations pour la liste complète des filtres ; en plus du paramètre obligatoire user_ids[], les bornes updated_at.* sont utiles pour la revue incrémentale des conversations qui ont changé depuis un export précédent.

Les résultats de conversations sont triés par created_at croissant (les plus anciennes en premier), les égalités étant départagées par id. La pagination utilise les mêmes champs de curseur first_id/last_id/has_more que Paginer les résultats ; passez last_id comme after_id pour avancer vers les conversations plus récentes, ou first_id comme before_id pour revenir vers les plus anciennes.

Pour extraire le contenu réel de la conversation, les fichiers joints et les artefacts intégrés (documents structurés que Claude génère au sein d'une conversation), effectuez un appel de suivi au point de terminaison des messages pour chaque ID de conversation :

chat_id="claude_chat_01H5CWunD7RpVJ5bHa8RCkja"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/chats/$chat_id/messages" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

Le point de terminaison des messages renvoie les métadonnées de la conversation ainsi qu'un tableau chat_messages trié par created_at. Lorsque limit est omis, l'ensemble complet des messages est renvoyé dans une seule réponse ; passez limit, after_id ou before_id pour paginer les conversations très longues. Le point de terminaison accepte également les bornes d'intervalle created_at.* et updated_at.* (gt, gte, lt, lte) ainsi qu'un paramètre order (asc ou desc). Consultez Obtenir les messages d'une conversation pour la liste complète des paramètres. Pour les messages utilisateur, created_at correspond au moment où le message a été envoyé ; pour les messages de l'assistant, il correspond au moment où Claude a terminé de générer le message. Chaque message contient son contenu textuel et, le cas échéant, les fichiers téléversés (généralement sur les messages utilisateur), les fichiers générés par des outils, et les artefacts que l'assistant a produits ou mis à jour (généralement sur les messages de l'assistant) :

{
  "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "name": "Product Requirements Discussion",
  "created_at": "2026-04-10T08:09:10Z",
  "updated_at": "2026-04-10T09:10:11Z",
  "deleted_at": null,
  "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789",
  "model": "claude-opus-4-8",
  "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
  "user": {
    "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
    "email_address": "[email protected]"
  },
  "chat_messages": [
    {
      "id": "claude_chat_msg_01VnBPkLmtj7YdW5QrXKEA8c",
      "role": "user",
      "created_at": "2026-04-10T08:09:10Z",
      "content": [
        {
          "type": "text",
          "text": "Can you help me draft requirements for our new dashboard feature?"
        }
      ],
      "files": [
        {
          "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
          "filename": "dashboard_mockup_v1.pdf",
          "mime_type": "application/pdf"
        }
      ]
    },
    {
      "id": "claude_chat_msg_01M8tFcHwbQ2kY6NpEjRZv4D",
      "role": "assistant",
      "created_at": "2026-04-10T08:09:11Z",
      "content": [
        {
          "type": "text",
          "text": "I'd be happy to help you draft requirements for your dashboard feature..."
        }
      ],
      "generated_files": [
        {
          "id": "claude_gen_file_01TbR8wAcCeFhJkLnPqStUvX",
          "filename": "requirements_summary.csv",
          "mime_type": "text/csv"
        }
      ],
      "artifacts": [
        {
          "id": "claude_artifact_01HqRsTuVwXyZa2BcDeFgH4J",
          "version_id": "claude_artifact_version_01KmNpQrSt3UvWxYz5AbCdEfG",
          "title": "Dashboard Requirements Draft",
          "artifact_type": "text/markdown"
        }
      ]
    }
  ],
  "has_more": false,
  "first_id": "eyJtc2dfdXVpZCI6ICIwZjcwYjA2Ni0uLi4ifQ==",
  "last_id": "eyJtc2dfdXVpZCI6ICJhNGUwYjE3Mi0uLi4ifQ=="
}

files, generated_files et artifacts peuvent chacun être null sur un message donné. Les files sont des téléversements binaires (PDF, images, feuilles de calcul) que l'utilisateur a joints au message. Les generated_files sont des fichiers binaires que l'assistant a créés pendant la conversation via l'utilisation d'outils (par exemple, des PDF, des feuilles de calcul ou des présentations). Les artifacts sont des documents versionnés (par exemple, du code ou du markdown) que l'assistant a générés ou mis à jour dans sa réponse ; un artefact peut être révisé sur plusieurs tours de l'assistant dans la même conversation, et chaque révision apparaît comme un nouveau version_id sous le même id d'artefact. Passez l'id de chaque entrée (ou le version_id pour les artefacts) au point de terminaison de contenu correspondant dans Récupérer des fichiers et des artefacts pour le télécharger.

Récupérer des fichiers et des artefacts

Les fichiers et les artefacts sont téléchargés par ID, et non listés indépendamment. Les ID proviennent du point de terminaison des messages de conversation dans Récupérer des conversations et des messages (les tableaux files, generated_files et artifacts de chaque message) ou, pour les téléversements au niveau du projet, du point de terminaison des pièces jointes de projet.

Choisissez le point de terminaison qui correspond à votre type d'ID et aux données dont vous avez besoin. Le même point de terminaison de contenu de fichier sert à la fois les fichiers de conversation et les fichiers de projet.

Le point de terminaison de contenu de fichier diffuse le téléversement d'origine sous forme de réponse binaire fragmentée avec les en-têtes suivants :

• Content-Disposition: attachment; filename*=utf-8''<percent-encoded filename> contient le nom du fichier téléversé d'origine au format étendu RFC 5987. Le format étendu est utilisé pour tous les noms de fichiers, pas seulement ceux contenant des caractères non-ASCII.
• Content-Type contient le type MIME du téléversement.
• Content-MD5 contient le condensé MD5 du fichier, encodé en base64 comme spécifié dans la RFC 1864.
• Transfer-Encoding: chunked est toujours défini.

file_id="claude_file_01UaT9wBcDfGhJkLmNpQrSv7"

curl --fail-with-body -sS -OJ \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  "https://api.anthropic.com/v1/compliance/apps/chats/files/$file_id/content"

Les options -OJ indiquent à curl d'enregistrer la réponse sous le nom de fichier provenant de Content-Disposition, qui est le nom de fichier d'origine téléversé par l'utilisateur.

Le point de terminaison de contenu d'artefact renvoie le corps textuel d'une version d'artefact. Passez le version_id de l'une des entrées du tableau artifacts d'un message de l'assistant, et non l'id stable de l'artefact. Chaque nouvelle version d'un artefact possède son propre version_id, et l'API de conformité sert les octets exacts de cette version.

Récupérer des projets et des pièces jointes

Les projets regroupent des conversations connexes avec des instructions personnalisées, du contenu de base de connaissances et des fichiers ou documents texte joints. L'API de conformité expose les métadonnées de projet, les détails de projet et la liste des pièces jointes appartenant à un projet.

• Lister les projets
• Obtenir les détails d'un projet
• Lister les pièces jointes d'un projet
• Obtenir le contenu d'un document de projet

Les résultats de projets sont triés par date de création croissante. Les résultats de pièces jointes sont triés par created_at croissant, les égalités étant départagées par id. Les réponses de liste de projets et de liste de pièces jointes paginent avec un jeton de page opaque next_page au lieu des curseurs first_id/last_id utilisés par les conversations et le flux d'activité. Repassez le jeton comme paramètre de requête page lors de la requête suivante.

Fichiers de projet versus documents de projet

Une pièce jointe de projet prend l'une de deux formes distinctes, identifiée par le discriminateur type sur chaque entrée :

Les entrées avec un type de project_file sont des téléversements binaires (PDF, images, feuilles de calcul) dont les ID commencent par claude_file_ ; téléchargez-les avec Télécharger le contenu d'un fichier. Les entrées avec un type de project_doc sont des documents en texte brut (toujours text/plain) dont les ID commencent par claude_proj_doc_ ; récupérez-les avec Obtenir le contenu d'un document de projet.

Un consommateur qui parcourt la liste des pièces jointes doit effectuer un branchement sur type et appeler le point de terminaison de contenu correspondant pour chaque entrée. La requête suivante liste une page de pièces jointes ; paginez en repassant next_page comme paramètre page jusqu'à ce que has_more soit false.

project_id="claude_proj_01KGp4eZNug9ri4kE35RSppq"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/projects/$project_id/attachments" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
      "created_at": "2026-04-10T08:09:10Z",
      "filename": "dashboard_mockup_v1.pdf",
      "mime_type": "application/pdf",
      "type": "project_file"
    },
    {
      "id": "claude_proj_doc_01YnT8sBcWvUtXzQpMkRfDgH",
      "created_at": "2026-04-10T08:09:11Z",
      "filename": "requirements.md",
      "mime_type": "text/plain",
      "type": "project_doc"
    }
  ],
  "has_more": false,
  "next_page": null
}

Supprimer du contenu

L'API de conformité expose des points de terminaison de suppression définitive pour les conversations, les fichiers, les documents de projet et les projets entiers. Une conversation supprimée définitivement ne peut pas être restaurée et cesse d'apparaître dans les réponses de liste par la suite (alors qu'une conversation supprimée de manière réversible depuis claude.ai apparaît toujours avec deleted_at renseigné).

• Supprimer une conversation : supprime également les messages de la conversation et tous les fichiers joints à ces messages.
• Supprimer un fichier : gère à la fois les fichiers de conversation et les fichiers de projet.
• Supprimer un document de projet : supprime un seul document de projet par ID.
• Supprimer un projet : consultez Détacher les conversations avant de supprimer un projet.

Les quatre points de terminaison nécessitent la portée delete:compliance_user_data, qui est accordée séparément de la portée de lecture lors de la création de la clé d'accès de conformité.

La requête suivante supprime une conversation. Le même schéma s'applique aux autres points de terminaison de suppression ; seule l'URL change.

# AVERTISSEMENT : cette opération supprime DÉFINITIVEMENT la conversation, tous ses messages
# et tous les fichiers joints. La suppression est immédiate et irréversible. Elle
# requiert la portée `delete:compliance_user_data`, qui est accordée séparément
# de `read:compliance_user_data` lors de la création de la clé d'accès de conformité.
# Assurez-vous de disposer d'une autorisation explicite avant d'exécuter ceci.

chat_id="claude_chat_01H5CWunD7RpVJ5bHa8RCkja"

curl --fail-with-body -sS -X DELETE \
  "https://api.anthropic.com/v1/compliance/apps/chats/$chat_id" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "type": "claude_chat_deleted"
}

Chaque suppression réussie renvoie une petite enveloppe de confirmation avec un id et un discriminateur type. Le point de terminaison de conversation renvoie claude_chat_deleted ; vérifiez le champ type avant de considérer la suppression comme confirmée. Consultez le schéma de réponse sur la page de référence API de chaque point de terminaison de suppression pour connaître la valeur type exacte renvoyée par les autres points de terminaison.

Détacher les conversations avant de supprimer un projet

Un projet ne peut pas être supprimé tant que des conversations y restent attachées. L'API renvoie 409 avec ce corps :

{
  "error": {
    "type": "conflict_error",
    "message": "The \"claude_proj_01KGp4eZNug9ri4kE35RSppq\" project cannot be deleted as it has chats attached to it. Delete or detach all chats, and try deleting the project again."
  }
}

Pour résoudre ce problème, listez les conversations du projet avec GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id} (le point de terminaison de liste des conversations nécessite au moins une valeur user_ids[] ; énumérez les ID via Lister les utilisateurs de l'organisation), supprimez chacune d'elles avec DELETE /v1/compliance/apps/chats/{claude_chat_id} (ou déplacez-la hors du projet depuis claude.ai), puis réessayez la suppression du projet.

Étapes suivantes