Mengambil dan menghapus chat, file, dan proyek

Endpoint di halaman ini menyediakan konten chat, unggahan file, proyek, dan lampiran proyek Claude Enterprise kepada peninjau kepatuhan. Endpoint ini mendukung ekspor "eDiscovery" (penemuan elektronik), penegakan "data loss prevention" (pencegahan kehilangan data), atau DLP, serta respons penghapusan akun. Konten chat, file, dan proyek disimpan selama kebijakan retensi organisasi Anda mengizinkan. Ketika pengguna menghapus chat di claude.ai, konten pesannya, file yang dilampirkan, file yang dihasilkan alat, dan artifact-nya ikut dihapus. Compliance API tetap mencantumkan chat tersebut, dengan deleted_at terisi dan name kosong, serta mengembalikan pesan-pesannya tanpa kontennya. Chat yang telah dihapus permanen (melalui Compliance API itu sendiri, atau setelah jendela retensi organisasi berakhir) tidak dapat diambil.

Kedua scope hanya diberikan pada Compliance Access Key (sk-ant-api01-...) yang dibuat di claude.ai; lihat Menyiapkan Compliance API untuk menyediakannya. Scope read:compliance_user_data mencakup pengambilan; delete:compliance_user_data hanya diperlukan untuk endpoint penghapusan. Endpoint chat, file, proyek, dan lampiran tidak tersedia untuk kunci Admin API (sk-ant-admin01-...); panggilan yang diautentikasi dengan kunci Admin API mengembalikan 403 Forbidden.

Endpoint di halaman ini melakukan paginasi dengan dua cara; lihat Paginasi hasil untuk referensi lengkapnya. Setiap bagian mencatat skema mana yang berlaku.

Mengambil chat dan pesan

Gunakan Mencantumkan chat untuk menelusuri metadata chat halaman demi halaman, lalu Mendapatkan pesan chat untuk mengambil konten pesan lengkap dari satu chat.

Chat dalam pengalaman Claude terpadu dikembalikan oleh endpoint ini seperti chat lainnya: chat yang berlanjut dalam sesi di cloud dikembalikan sebagai satu chat. Pekerjaan yang dilakukan Claude di sana muncul di content setiap pesan sebagai blok tool_use (name dan input alat) dan blok tool_result (outputnya, dicocokkan dengan tool_use_id). Cakupan chat ini masih dalam tahap beta.

Endpoint daftar chat secara default menggunakan cakupan seluruh organisasi: hilangkan user_ids[] untuk menyertakan setiap chat di bawah organisasi induk Anda. Tambahkan order_by=updated_at untuk mengurutkan berdasarkan waktu pembaruan terakhir. Kombinasi ini adalah cara yang direkomendasikan untuk mengekspor chat dan menjaga ekspor tetap terkini, karena satu loop paginasi menangkap chat baru, chat dengan pesan baru, dan chat yang dihapus di claude.ai untuk setiap pengguna tanpa harus mengenumerasi pengguna terlebih dahulu. Permintaan berikut mencantumkan chat yang diperbarui sejak tanggal tertentu.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/chats" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data-urlencode "order_by=updated_at" \
  --data-urlencode "updated_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-5-5",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
      "user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "user@example.com"
      }
    }
  ],
  "has_more": true,
  "first_id": "eyJrIjogInVwZGF0ZWRfYXQiLCAidCI6ICIyMDI2LTA0LTEwVDA5OjEwOjExKzAwOjAwIiwgImlkIjogImFiY2RlZjAxLS4uLiJ9",
  "last_id": "eyJrIjogInVwZGF0ZWRfYXQiLCAidCI6ICIyMDI2LTA0LTEwVDA5OjEwOjExKzAwOjAwIiwgImlkIjogImFiY2RlZjAxLS4uLiJ9"
}

Hasil diurutkan secara menaik berdasarkan field order_by, yang terlama terlebih dahulu, dengan nilai yang sama diurutkan berdasarkan id. Paginasi menggunakan field kursor standar first_id/last_id/has_more yang dijelaskan di Memaginasi hasil. Untuk bergerak maju ke chat yang lebih baru, kirimkan kembali last_id dari respons sebagai after_id pada permintaan berikutnya.

Penelusuran maju tersebut juga merupakan cara Anda menjaga ekspor tetap terkini di setiap eksekusi: simpan last_id dari halaman terakhir dan lanjutkan darinya sebagai after_id pada eksekusi berikutnya. Karena daftar diurutkan berdasarkan updated_at, sebuah chat muncul kembali setelah kursor yang Anda simpan ketika chat tersebut menerima pesan baru, dipindahkan ke dalam atau keluar dari proyek, atau dihapus di claude.ai. Oleh karena itu, setiap eksekusi inkremental mengembalikan chat yang benar-benar baru sekaligus chat lama yang telah berubah dengan salah satu cara tersebut. Pengeditan lain, seperti penggantian nama, tidak dijamin membuat chat muncul kembali. Proses hasil secara idempoten, dengan kunci id chat, untuk menangani kemunculan ulang tersebut. Chat yang kembali dengan deleted_at terisi tidak memiliki konten tersisa untuk diambil, jadi perlakukan sebagai terhapus, bukan diperbarui.

Beberapa batasan berlaku untuk kueri seluruh organisasi ini. Kursor bersifat opaque dan terikat pada kunci pengurutan, sehingga after_id yang diterbitkan di bawah satu nilai order_by akan ditolak dengan error 400 di bawah nilai lainnya. Batas filter waktu juga harus sesuai dengan kunci pengurutan: pasangkan batas updated_at.* dengan order_by=updated_at, dan batas created_at.* dengan default order_by=created_at. Paginasi mundur dengan before_id tidak didukung, dan filter project_ids[] tidak tersedia. Lihat Mencantumkan chat untuk referensi filter lengkap.

Untuk membatasi daftar ke pengguna tertentu (misalnya, "legal hold" (penahanan hukum) pada kustodian yang disebutkan namanya), kirimkan 1–10 nilai user_ids[]. Dapatkan ID dari Mencantumkan pengguna organisasi. Kueri yang difilter berdasarkan pengguna selalu diurutkan berdasarkan created_at (mengirimkan order_by=updated_at mengembalikan error 400) dan mendukung after_id maupun before_id. Pemfilteran berdasarkan project_ids[] hanya tersedia dalam bentuk yang difilter berdasarkan pengguna ini. Menggabungkan user_ids[] dengan batas updated_at.* apa pun sudah tidak digunakan lagi (deprecated) dan akan ditolak dengan error 400 setelah 2026-09-22; untuk menjaga kumpulan kustodian tetap terkini berdasarkan waktu pembaruan, jalankan penelusuran order_by=updated_at seluruh organisasi tanpa user_ids[] dan pilih chat para kustodian dari hasilnya, serta gunakan daftar yang difilter berdasarkan pengguna untuk ekspor yang diurutkan berdasarkan created_at.

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

Respons daftar hanya memuat metadata chat. Untuk mengambil konten chat yang sebenarnya, file terlampir, dan artifact inline (dokumen terstruktur yang dihasilkan Claude di dalam chat), lanjutkan dengan endpoint pesan untuk setiap 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" \
  --header "anthropic-version: 2023-06-01"

Endpoint pesan mengembalikan metadata chat ditambah array chat_messages yang diurutkan berdasarkan created_at. Ketika limit dihilangkan, seluruh kumpulan pesan dikembalikan dalam satu respons; kirimkan limit, after_id, atau before_id untuk menelusuri chat yang sangat panjang halaman demi halaman. Endpoint ini juga menerima batas rentang created_at.* dan updated_at.* (gt, gte, lt, lte) serta parameter order (asc atau desc). Lihat Mendapatkan pesan chat untuk daftar parameter lengkap. Untuk pesan pengguna, created_at adalah waktu pesan dikirim; untuk pesan asisten, itu adalah waktu Claude selesai menghasilkan pesan. Setiap pesan memuat konten teksnya dan, jika ada, file yang diunggah (biasanya pada pesan pengguna), file yang dihasilkan alat, dan artifact yang dihasilkan atau diperbarui oleh asisten (biasanya pada pesan asisten):

{
  "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-5-5",
  "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
  "user": {
    "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
    "email_address": "user@example.com"
  },
  "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",
          "size_bytes": 482133,
          "md5": "56367e4d2705cc9c025ad07424e944f0",
          "created_at": "2026-04-10T08:09:10Z"
        }
      ]
    },
    {
      "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",
          "size_bytes": 2048,
          "md5": "89968669461d95416549937168269d6b"
        }
      ],
      "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, dan artifacts masing-masing dapat bernilai null pada pesan tertentu. files adalah file dan lampiran teks (misalnya, PDF, gambar, spreadsheet, dokumen, dan teks yang ditempel) yang dilampirkan pengguna ke pesan, sebagaimana disimpan oleh claude.ai. generated_files adalah file biner yang dibuat asisten selama percakapan melalui "tool use" (penggunaan alat), misalnya PDF, spreadsheet, atau slide presentasi. artifacts adalah dokumen berversi (misalnya, kode atau markdown) yang dihasilkan atau diperbarui asisten dalam responsnya; sebuah artifact dapat direvisi di beberapa giliran asisten dalam chat yang sama, dan setiap revisi muncul sebagai version_id baru di bawah id artifact yang sama. Kirimkan id setiap entri (atau version_id untuk artifact) ke endpoint konten yang sesuai di Mengambil file dan artifact untuk mengunduhnya.

Mengambil file dan artifact

File dan artifact diunduh berdasarkan ID. Kecuali untuk dokumen Claude Docs (lihat akhir bagian ini), file dan artifact tidak dicantumkan secara terpisah. ID berasal dari endpoint pesan chat di Mengambil chat dan pesan (array files, generated_files, dan artifacts pada setiap pesan) atau, untuk unggahan tingkat proyek, dari endpoint lampiran proyek.

Pilih endpoint yang sesuai dengan jenis ID Anda dan data yang Anda butuhkan. Endpoint konten file yang sama melayani file chat maupun file proyek.

Endpoint konten file melakukan streaming konten yang disimpan claude.ai untuk file tersebut sebagai respons biner chunked. Konten itu tidak selalu identik dengan file yang diunggah pengguna:

• Gambar dapat disajikan sebagai salinan yang telah diproses, bukan byte asli yang diunggah.
• Beberapa dokumen yang dilampirkan ke chat (misalnya, file Word, file PowerPoint, dan sebagian PDF) disimpan sebagai teks yang diekstrak claude.ai darinya. Untuk dokumen seperti ini, endpoint mengembalikan teks hasil ekstraksi dengan nama file asli, dan dokumen aslinya tidak tersedia melalui Compliance API.

Field size_bytes dan md5 menggambarkan konten yang disimpan, bukan file yang diunggah. Nama file dan mime_type mungkin tetap menunjukkan format dokumen yang diunggah. Karena itu, tentukan format file dari byte yang dikembalikan, bukan dari nama atau tipe yang dideklarasikan.

Respons menyertakan header berikut:

• Content-Disposition: attachment; filename*=utf-8''<percent-encoded filename> berisi nama file unggahan asli dalam bentuk extended RFC 5987. Bentuk extended ini digunakan untuk setiap nama file, tidak hanya yang mengandung karakter non-ASCII.
• Content-Type berisi tipe MIME yang tercatat untuk konten yang disimpan. Untuk dokumen yang disimpan sebagai teks hasil ekstraksi, nilainya mungkin tetap menunjukkan format dokumen asli.
• Content-MD5 berisi digest MD5 dari byte yang disajikan, dienkode base64 sesuai RFC 1864.
• Transfer-Encoding: chunked selalu disetel.

file_id="claude_file_01UaT9wBcDfGhJkLmNpQrSv7"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/chats/files/$file_id/content" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --output "dashboard_mockup_v1.pdf"

Di curl, opsi --remote-header-name (-J) biasanya menyimpan unduhan dengan nama file dari Content-Disposition, tetapi opsi ini tidak membaca bentuk filename*. Karena itu, tentukan sendiri nama file yang disimpan dengan --output. Dalam skrip, ambil nama dari field filename file tersebut di respons pesan chat atau Mendapatkan metadata file, atau dekode filename*.

Apa pun caranya, nama tersebut adalah nama yang diberikan pengguna saat mengunggah, jadi anggap tidak tepercaya sebelum menggunakannya sebagai path output:

• Ambil hanya nama dasarnya.
• Izinkan hanya karakter yang aman untuk sistem file Anda.
• Tolak nama yang diawali dengan - atau ..

Berbeda dengan endpoint konten file, endpoint konten artifact mengembalikan objek JSON. Kirimkan version_id dari salah satu entri dalam array artifacts pada pesan asisten, bukan id artifact yang stabil. Setiap versi baru artifact memiliki version_id sendiri. Field content pada respons berisi teks dari versi tersebut secara persis, sedangkan field title dan artifact_type menggambarkan artifact-nya. Mendapatkan metadata artifact menghitung size_bytes dan md5 dari encoding UTF-8 teks tersebut. Jadi, bandingkan keduanya dengan nilai content, bukan dengan seluruh body respons.

Dokumen Claude Docs dicantumkan secara terpisah, oleh Mencantumkan artifact kode, dengan artifact_type disetel ke claude_docs. Daftar versions dokumen kosong dan published_version_id-nya bernilai null. Untuk mengunduh teks terkini dokumen, panggil GET /v1/compliance/apps/code/artifacts/{artifact_id}/content?multi_file_format=zip. Ini mengembalikan arsip ZIP dengan satu file Word (.docx) untuk setiap tab yang berisi teks. Komentar, file yang diunggah, dan riwayat pengeditan tidak disertakan. Mengunduh Claude Docs melalui Compliance API masih dalam beta.

Mengambil proyek dan lampiran

Proyek mengelompokkan chat yang saling terkait beserta instruksi kustom, konten basis pengetahuan, dan file atau dokumen teks terlampir. Compliance API menyediakan metadata proyek, detail proyek, dan daftar lampiran milik sebuah proyek.

• Mencantumkan proyek
• Mendapatkan detail proyek
• Mencantumkan lampiran proyek
• Mendapatkan konten dokumen proyek

Hasil proyek diurutkan secara menaik berdasarkan tanggal pembuatan. Hasil lampiran diurutkan secara menaik berdasarkan created_at, dan jika nilainya sama, urutan ditentukan oleh id. Respons daftar proyek dan daftar lampiran menggunakan token halaman next_page yang bersifat opaque untuk paginasi, bukan kursor first_id/last_id seperti pada chat dan Activity Feed. Kirimkan token tersebut sebagai parameter kueri page pada permintaan berikutnya.

File proyek versus dokumen proyek

Lampiran proyek memiliki salah satu dari dua bentuk berbeda, yang dibedakan oleh diskriminator type pada setiap entri:

• Entri dengan type bernilai project_file adalah unggahan file (PDF, gambar, spreadsheet) dengan ID yang diawali claude_file_. Unduh dengan Mengunduh konten file.
• Entri dengan type bernilai project_doc adalah dokumen teks biasa (selalu text/plain) dengan ID yang diawali claude_proj_doc_. Ini termasuk dokumen seperti file Word yang dikonversi claude.ai menjadi teks saat ditambahkan ke proyek. Ambil dengan Mendapatkan konten dokumen proyek.

Kode yang menelusuri daftar lampiran harus bercabang berdasarkan type dan memanggil endpoint konten yang sesuai untuk setiap entri. Permintaan berikut mencantumkan satu halaman lampiran. Untuk paginasi, kirimkan next_page sebagai parameter page hingga has_more bernilai 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" \
  --header "anthropic-version: 2023-06-01"

{
  "data": [
    {
      "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
      "created_at": "2026-04-10T08:09:10Z",
      "filename": "dashboard_mockup_v1.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 482133,
      "md5": "56367e4d2705cc9c025ad07424e944f0",
      "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
}

Menghapus konten

Compliance API mengekspos endpoint penghapusan permanen untuk chat, file, dokumen proyek, dan seluruh proyek. Chat yang dihapus permanen tidak dapat dipulihkan, dan tidak lagi muncul di respons daftar setelahnya.

• Menghapus chat: juga menghapus pesan chat dan file apa pun yang dilampirkan ke pesan tersebut.
• Menghapus file: menangani file chat maupun file proyek.
• Menghapus dokumen proyek: menghapus satu dokumen proyek berdasarkan ID.
• Menghapus proyek: lihat Melepaskan chat sebelum menghapus proyek.

Untuk chat dalam pengalaman Claude terpadu, Menghapus chat juga menghapus sesi di cloud yang dimulai untuk chat tersebut. Endpoint ini tidak menghapus sesi yang dimulai oleh sesi-sesi tersebut.

Keempat endpoint memerlukan scope delete:compliance_user_data, yang diberikan secara terpisah dari scope baca saat Compliance Access Key dibuat.

Permintaan berikut menghapus satu chat. Pola yang sama berlaku untuk endpoint penghapusan lainnya; hanya URL yang berubah.

# PERINGATAN: Operasi ini menghapus chat secara PERMANEN, beserta semua pesannya,
# dan semua file terlampir. Penghapusan terjadi seketika dan tidak dapat dibatalkan. Operasi ini
# memerlukan scope `delete:compliance_user_data`, yang diberikan terpisah
# dari `read:compliance_user_data` saat Compliance Access Key dibuat.
# Pastikan Anda memiliki otorisasi eksplisit sebelum menjalankan ini.

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" \
  --header "anthropic-version: 2023-06-01"

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

Setiap penghapusan yang berhasil mengembalikan envelope konfirmasi kecil dengan id dan diskriminator type. Endpoint chat mengembalikan claude_chat_deleted; periksa field type sebelum menganggap penghapusan telah dikonfirmasi. Lihat skema respons di halaman referensi API setiap endpoint penghapusan untuk nilai type persis yang dikembalikan endpoint lainnya.

Melepaskan chat sebelum menghapus proyek

Proyek tidak dapat dihapus selama masih ada chat yang terlampir padanya. API mengembalikan 409 dengan body berikut:

{
  "error": {
    "type": "invalid_request_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."
  }
}

Untuk mengatasinya:

1. Cantumkan chat milik proyek dengan GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id}. Filter project_ids[] memerlukan setidaknya satu nilai user_ids[]; dapatkan ID tersebut melalui Mencantumkan pengguna organisasi.
2. Hapus setiap chat dengan DELETE /v1/compliance/apps/chats/{claude_chat_id}, atau pindahkan chat keluar dari proyek melalui claude.ai.
3. Coba lagi penghapusan proyek.

Langkah selanjutnya