Recuperare ed eliminare chat, file e progetti

Gli endpoint in questa pagina espongono ai revisori della conformità il contenuto delle chat di claude.ai, i file caricati, i progetti e gli allegati dei progetti. Supportano le esportazioni di "eDiscovery" (electronic discovery, individuazione elettronica), l'applicazione della "data loss prevention" (prevenzione della perdita di dati), o DLP, e le risposte alle richieste di eliminazione degli account. I contenuti vengono conservati per tutto il tempo consentito dalla policy di conservazione della tua organizzazione. Le chat che un utente ha eliminato in modo soft in claude.ai rimangono visibili tramite la Compliance API con il campo deleted_at valorizzato; le chat che sono state eliminate in modo hard (tramite la Compliance API stessa, o dopo la scadenza della finestra di conservazione dell'organizzazione) non sono recuperabili.

Entrambi gli scope vengono concessi solo sulle Compliance Access Key (sk-ant-api01-...) create in claude.ai; consulta Ottenere l'accesso alla Compliance API per crearne una. Lo scope read:compliance_user_data copre il recupero; delete:compliance_user_data è richiesto solo per gli endpoint di eliminazione. Gli endpoint di chat, file, progetti e allegati non sono disponibili per le chiavi Admin API (sk-ant-admin01-...); le chiamate autenticate con una chiave Admin API restituiscono 403 Forbidden.

Gli endpoint in questa pagina utilizzano due modalità di paginazione; consulta Paginare i risultati per il riferimento completo. Ogni sezione indica quale schema si applica.

Recuperare chat e messaggi

Usa List chats per scorrere i metadati delle chat, quindi Get chat messages per recuperare il contenuto completo dei messaggi di una chat.

L'endpoint di elenco delle chat richiede almeno un valore user_ids[] (e ne accetta fino a 10 in una singola richiesta), quindi enumera prima gli ID utente con Elencare gli utenti dell'organizzazione, poi elenca le chat per ciascun utente o per ciascun batch di utenti. La seguente richiesta elenca le chat di proprietà di un utente specifico a partire da una determinata data.

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

L'elenco delle chat restituisce solo metadati. Consulta List chats per l'elenco completo dei filtri; oltre al parametro obbligatorio user_ids[], i limiti updated_at.* sono utili per la revisione incrementale delle chat che sono cambiate dall'ultima esportazione.

I risultati delle chat sono ordinati per created_at in ordine crescente (dalla più vecchia), con i pareggi risolti in base a id. La paginazione utilizza gli stessi campi cursore first_id/last_id/has_more descritti in Paginare i risultati; passa last_id come after_id per avanzare verso le chat più recenti, oppure first_id come before_id per tornare indietro verso quelle più vecchie.

Per recuperare il contenuto effettivo della chat, i file allegati e gli artifact inline (documenti strutturati che Claude genera all'interno di una chat), prosegui con l'endpoint dei messaggi per ciascun ID chat:

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"

L'endpoint dei messaggi restituisce i metadati della chat più un array chat_messages ordinato per created_at. Quando limit viene omesso, l'intero set di messaggi viene restituito in una singola risposta; passa limit, after_id o before_id per paginare chat molto lunghe. L'endpoint accetta anche limiti di intervallo created_at.* e updated_at.* (gt, gte, lt, lte) e un parametro order (asc o desc). Consulta Get chat messages per l'elenco completo dei parametri. Per i messaggi dell'utente, created_at indica quando il messaggio è stato inviato; per i messaggi dell'assistente, indica quando Claude ha terminato di generare il messaggio. Ogni messaggio contiene il proprio contenuto testuale e, quando presenti, eventuali file caricati (tipicamente nei messaggi dell'utente), eventuali file generati da strumenti ed eventuali artifact che l'assistente ha prodotto o aggiornato (tipicamente nei messaggi dell'assistente):

{
  "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 e artifacts possono essere ciascuno null in un determinato messaggio. I files sono caricamenti binari (PDF, immagini, fogli di calcolo) che l'utente ha allegato al messaggio. I generated_files sono file binari che l'assistente ha creato durante la conversazione tramite l'uso degli strumenti (ad esempio PDF, fogli di calcolo o presentazioni). Gli artifacts sono documenti versionati (ad esempio codice o markdown) che l'assistente ha generato o aggiornato nella sua risposta; un artifact può essere rivisto in più turni dell'assistente all'interno della stessa chat, e ogni revisione appare come un nuovo version_id sotto lo stesso id dell'artifact. Passa l'id di ciascuna voce (o version_id per gli artifact) all'endpoint di contenuto corrispondente in Recuperare file e artifact per scaricarlo.

Recuperare file e artifact

I file e gli artifact vengono scaricati tramite ID, non elencati in modo indipendente. Gli ID provengono dall'endpoint dei messaggi della chat in Recuperare chat e messaggi (gli array files, generated_files e artifacts su ciascun messaggio) oppure, per i caricamenti a livello di progetto, dall'endpoint degli allegati del progetto.

Scegli l'endpoint che corrisponde al tuo tipo di ID e ai dati di cui hai bisogno. Lo stesso endpoint di contenuto file serve sia i file delle chat sia i file dei progetti.

L'endpoint di contenuto file trasmette in streaming il caricamento originale come risposta binaria a blocchi con questi header:

• Content-Disposition: attachment; filename*=utf-8''<percent-encoded filename> contiene il nome file originale del caricamento nella forma estesa RFC 5987. La forma estesa viene utilizzata per ogni nome file, non solo per quelli non ASCII.
• Content-Type contiene il tipo MIME del caricamento.
• Content-MD5 contiene il digest MD5 del file, codificato in base64 come specificato in RFC 1864.
• Transfer-Encoding: chunked è sempre impostato.

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"

I flag -OJ indicano a curl di salvare la risposta con il nome file presente in Content-Disposition, che è il nome file originale caricato dall'utente.

L'endpoint di contenuto artifact restituisce il corpo testuale di una versione dell'artifact. Passa il version_id di una delle voci nell'array artifacts di un messaggio dell'assistente, non l'id stabile dell'artifact. Ogni nuova versione di un artifact ha il proprio version_id, e la Compliance API serve i byte esatti di quella versione.

Recuperare progetti e allegati

I progetti raggruppano chat correlate insieme a istruzioni personalizzate, contenuti della knowledge base e file o documenti di testo allegati. La Compliance API espone i metadati dei progetti, i dettagli dei progetti e l'elenco degli allegati appartenenti a un progetto.

• List projects
• Get project details
• List project attachments
• Get project document content

I risultati dei progetti sono ordinati per data di creazione in ordine crescente. I risultati degli allegati sono ordinati per created_at in ordine crescente, con i pareggi risolti in base a id. Le risposte dell'elenco progetti e dell'elenco allegati utilizzano per la paginazione un token di pagina opaco next_page invece dei cursori first_id/last_id usati dalle chat e dall'Activity Feed. Passa il token come parametro di query page nella richiesta successiva.

File di progetto e documenti di progetto

Un allegato di progetto ha una di due forme distinte, identificate dal discriminatore type su ciascuna voce:

Le voci con type uguale a project_file sono caricamenti binari (PDF, immagini, fogli di calcolo) i cui ID iniziano con claude_file_; scaricali con Download file content. Le voci con type uguale a project_doc sono documenti in testo semplice (sempre text/plain) i cui ID iniziano con claude_proj_doc_; recuperali con Get project document content.

Un consumer che scorre l'elenco degli allegati deve diramare in base a type e chiamare l'endpoint di contenuto corrispondente per ciascuna voce. La seguente richiesta elenca una pagina di allegati; pagina passando next_page come parametro page finché has_more non è 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
}

Eliminare contenuti

La Compliance API espone endpoint di eliminazione hard per chat, file, documenti di progetto e interi progetti. Una chat eliminata in modo hard non può essere ripristinata e smette di apparire nelle risposte di elenco successive (mentre una chat eliminata in modo soft da claude.ai continua ad apparire con deleted_at valorizzato).

• Delete chat: rimuove anche i messaggi della chat e tutti i file allegati a quei messaggi.
• Delete file: gestisce sia i file delle chat sia i file dei progetti.
• Delete project document: rimuove un singolo documento di progetto tramite ID.
• Delete project: consulta Scollegare le chat prima di eliminare un progetto.

Tutti e quattro gli endpoint richiedono lo scope delete:compliance_user_data, che viene concesso separatamente dallo scope di lettura quando viene creata la Compliance Access Key.

La seguente richiesta elimina una chat. Lo stesso schema si applica agli altri endpoint di eliminazione; cambia solo l'URL.

# ATTENZIONE: Questa operazione elimina PERMANENTEMENTE la chat, tutti i suoi messaggi
# e qualsiasi file allegato. L'eliminazione è immediata e non può essere annullata.
# Richiede lo scope `delete:compliance_user_data`, che viene concesso separatamente
# da `read:compliance_user_data` quando viene creata la Compliance Access Key.
# Assicurati di avere un'autorizzazione esplicita prima di eseguire questa operazione.

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

Ogni eliminazione riuscita restituisce un piccolo envelope di conferma con un id e un discriminatore type. L'endpoint delle chat restituisce claude_chat_deleted; verifica il campo type prima di considerare l'eliminazione come confermata. Consulta lo schema di risposta nella pagina di riferimento API di ciascun endpoint di eliminazione per il valore esatto di type restituito dagli altri endpoint.

Scollegare le chat prima di eliminare un progetto

Un progetto non può essere eliminato finché rimangono chat collegate ad esso. L'API restituisce 409 con questo body:

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

Per risolvere, elenca le chat del progetto con GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id} (l'endpoint di elenco delle chat richiede almeno un valore user_ids[]; enumera gli ID tramite Elencare gli utenti dell'organizzazione), elimina ciascuna con DELETE /v1/compliance/apps/chats/{claude_chat_id} (oppure spostala fuori dal progetto da claude.ai), quindi riprova l'eliminazione del progetto.

Passaggi successivi