---
title: Mengambil transkrip sesi
url: https://platform.claude.com/docs/id/manage-claude/compliance-sessions
description: Daftarkan sesi yang dijalankan pengguna Anda di aplikasi dan agen Claude, seperti Claude Cowork dan Claude Code, dan ambil transkripnya melalui Compliance API.
---
Endpoint di halaman ini hanya tersedia untuk organisasi Claude Enterprise. Endpoint sesi lokal dan sesi jarak jauh sudah stabil untuk sesi Cowork, Claude Code, dan Claude for Microsoft 365; cakupan untuk sesi Claude Science dan Claude in Chrome masih dalam tahap beta. Endpoint ini bekerja dengan Compliance Access Key dan "scope" (cakupan) `read:compliance_user_data` yang sama seperti [endpoint chat, file, dan proyek](https://platform.claude.com/docs/id/manage-claude/compliance-content-data); tidak diperlukan kunci, cakupan, pengaturan, atau pembaruan klien baru. Lihat [Menyiapkan Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api-access).
**Cakupan yang diperlukan:** `read:compliance_user_data` pada Compliance Access Key.
**Prasyarat:** Tidak ada untuk mencantumkan sesi di seluruh organisasi. Untuk memfilter daftar sesi jarak jauh (sesi di cloud) ke pengguna tertentu, Anda memerlukan ID pengguna dari [Daftar pengguna organisasi](https://platform.claude.com/docs/id/manage-claude/compliance-org-data#list-organization-users); daftar sesi lokal tidak memiliki filter pengguna.
Endpoint di halaman ini menyediakan transkrip sesi yang dijalankan pengguna Anda di aplikasi dan agen Claude (saat ini: Cowork, Claude Code, Claude Science, Claude for Microsoft 365, dan Claude in Chrome) dari organisasi Claude Enterprise Anda kepada peninjau kepatuhan. Setiap sesi adalah satu percakapan dengan Claude; transkripnya adalah urutan prompt pengguna, respons asisten, serta panggilan alat dan hasilnya dalam percakapan tersebut. Endpoint ini mendukung ekspor "electronic discovery" (penemuan elektronik), atau eDiscovery, dan penegakan "data loss prevention" (pencegahan kehilangan data), atau DLP.
Compliance API mengelompokkan sesi ke dalam dua keluarga endpoint berdasarkan tempat sesi tersebut berjalan: endpoint sesi lokal untuk sesi di mesin pengguna, dan endpoint sesi jarak jauh untuk sesi yang berjalan di cloud dalam lingkungan yang dikelola Anthropic. Kedua keluarga bersifat hanya-baca, dan keduanya tidak tersedia untuk kunci Admin API (`sk-ant-admin01-...`): panggilan yang diautentikasi dengan kunci Admin API mengembalikan [403 Forbidden](https://platform.claude.com/docs/id/manage-claude/compliance-errors#403-forbidden).
Tabel berikut memetakan setiap produk, beserta tempat produk tersebut berjalan, ke keluarga endpoint yang mengembalikan sesinya dan nilai `product_surface` yang mengidentifikasinya dalam respons. Produk ditambahkan ke tabel ini seiring perluasan cakupan.
| Produk dan tempat berjalannya | Keluarga endpoint | `product_surface` |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cowork di Claude Desktop, berjalan di mesin pengguna | Endpoint sesi lokal (`/v1/compliance/apps/sessions/local`) | `cowork` |
| Claude Code di terminal, di Claude Desktop, atau di ekstensi IDE, berjalan di mesin pengguna | Endpoint sesi lokal | `claude_code` |
| Aplikasi desktop Claude Science, berjalan di mesin pengguna | Endpoint sesi lokal | `claude_science` |
| Claude for Microsoft 365 (add-in Claude untuk Excel, PowerPoint, Word, dan Outlook), berjalan di aplikasi desktop atau web Microsoft 365 | Endpoint sesi lokal | `office_agents/excel`, `office_agents/powerpoint`, `office_agents/word`, atau `office_agents/outlook` (`office_agents` jika aplikasinya tidak teridentifikasi) |
| Claude in Chrome (chat bawaan ekstensi browser), berjalan di mesin pengguna | Endpoint sesi lokal | `claude_in_chrome` |
| Sesi Cowork yang dimulai di claude.ai web atau seluler, berjalan di cloud dalam lingkungan yang dikelola Anthropic | Endpoint sesi jarak jauh (`/v1/compliance/apps/sessions/remote`) | `cowork_remote` |
Perekaman sesi lokal terkait dengan diaktifkannya Compliance API untuk organisasi Anda dan berlaku selama pengguna masuk dengan akun Claude Enterprise mereka. Endpoint sesi tidak mengembalikan hal-hal berikut:
* Sesi Claude Code yang diautentikasi dengan kunci API Claude Console, atau dijalankan melalui platform cloud pihak ketiga seperti Amazon Bedrock, Google Cloud, atau Microsoft Foundry.
* [Sesi cloud Claude Code](https://code.claude.com/docs/id/claude-code-on-the-web) (termasuk routine Claude Code yang berjalan di cloud), yang berjalan di infrastruktur cloud alih-alih di mesin pengguna. Sesi cloud ini bukan sesi jarak jauh, meskipun keduanya berjalan di cloud; endpoint sesi jarak jauh hanya mengembalikan sesi Cowork.
* Sesi lokal dari produk selain Cowork dan Claude Code di organisasi yang mengaktifkan [kesiapan HIPAA](https://platform.claude.com/docs/id/manage-claude/api-and-data-retention#hipaa-readiness). Di organisasi tersebut, endpoint sesi lokal hanya mengembalikan sesi Cowork dan Claude Code, dan konten sesi yang direkam disimpan selama 30 hari.
* Sesi lokal yang dikenai ["zero data retention" (retensi data nol), atau ZDR](https://platform.claude.com/docs/id/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope). Sesi ini dikecualikan dari hasil daftar, dan endpoint retrieve serta messages mengembalikan 404 untuk sesi tersebut.
Anthropic merekomendasikan Compliance API untuk mengambil konten sesi. Tabel berikut membandingkan [sesi lokal](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-local-sessions) dan [sesi jarak jauh](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-remote-sessions) dengan alternatif berbasis OpenTelemetry yang tersedia untuk Cowork dan Claude Code, yaitu [logging OpenTelemetry Cowork](https://support.claude.com/en/articles/14477985-monitor-claude-cowork-activity-with-opentelemetry) dan [pemantauan Claude Code](https://code.claude.com/docs/id/monitoring-usage).
| | Sesi lokal (di mesin pengguna) | Sesi jarak jauh (di cloud) | Logging OpenTelemetry |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Pengiriman | Pull: kueri dan ekspor melalui HTTPS | Pull: kueri dan ekspor melalui HTTPS | Push: di-stream ke kolektor OTLP Anda |
| Penyiapan | Bekerja dengan Compliance Access Key Anda yang sudah ada | Bekerja dengan Compliance Access Key Anda yang sudah ada | Admin mengonfigurasi endpoint OTLP dan pengaturan perekaman konten |
| Infrastruktur | Di-hosting oleh Anthropic | Di-hosting oleh Anthropic | Anda menjalankan kolektor dan penyimpanan |
| Prefiks ID | `clls_` | `cse_` | T/A |
| Nilai `product_surface` | `cowork`, `claude_code`, `claude_science`, `claude_in_chrome`, dan nilai yang diawali `office_agents` | `cowork_remote` | T/A |
| Retensi | 6 tahun secara default, atau periode retensi percakapan kustom organisasi Anda jika periode terbatas ditetapkan; 30 hari di organisasi yang mengaktifkan kesiapan HIPAA; disimpan oleh Anthropic | 6 tahun, kecuali pengguna menghapus sesi lebih awal; disimpan oleh Anthropic | Infrastruktur Anda, kebijakan Anda |
| Prompt pengguna dan respons asisten | Ya | Ya | Ya, tergantung pengaturan perekaman konten |
| Input alat | Dipotong menjadi 10.000 byte per input secara default; hingga sekitar 1 MiB atas permintaan | Dipotong menjadi 10.000 byte per input secara default; hingga sekitar 1 MiB atas permintaan | Ringkasan yang dipotong |
| Konten hasil alat | Setiap entri teks dipotong menjadi 10.000 byte secara default; hingga sekitar 1 MiB atas permintaan | Setiap entri teks dipotong menjadi 10.000 byte secara default; hingga sekitar 1 MiB atas permintaan | Metadata seperti ukuran dan keberhasilan; Claude Code juga dapat merekam konten dengan pengaturan opsional yang ukurannya dibatasi |
| Isi file | Ya, melalui panggilan alat dalam transkrip (hanya teks; konten lain muncul sebagai placeholder) | Ya, melalui panggilan alat dalam transkrip (hanya teks; konten lain dihilangkan) | Path file; Claude Code juga dapat merekam isi dengan pengaturan opsional yang ukurannya dibatasi |
| Metadata host dan perangkat (jenis terminal, path workspace) | Tidak | Tidak | Ya |
| Penggunaan token dan biaya | Tidak; tersedia melalui [Claude Enterprise Analytics API](https://platform.claude.com/docs/id/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) | Tidak; tersedia melalui [Claude Enterprise Analytics API](https://platform.claude.com/docs/id/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) | Ya |
## Sesi di mesin pengguna (sesi lokal)
Sesi lokal berjalan di mesin pengguna selama mereka masuk dengan akun Claude Enterprise mereka: saat ini, Cowork di Claude Desktop, Claude Code (di terminal, di Claude Desktop, atau di ekstensi IDE), aplikasi desktop Claude Science, Claude for Microsoft 365 (di Excel, PowerPoint, Word, dan Outlook), dan ekstensi browser Claude in Chrome.
Compliance API menyediakan sesi lokal melalui tiga endpoint: `GET /v1/compliance/apps/sessions/local` mencantumkan metadata sesi, `GET /v1/compliance/apps/sessions/local/{session_id}` mengambil metadata satu sesi, dan `GET /v1/compliance/apps/sessions/local/{session_id}/messages` mengembalikan transkrip satu sesi. Ketiganya memerlukan cakupan `read:compliance_user_data` dan hanya dihitung terhadap "rate limit" (batas laju) Compliance API bersama; ketiganya tidak dikenai anggaran permintaan kedua yang berlaku untuk endpoint sesi jarak jauh. Lihat [429 Too Many Requests](https://platform.claude.com/docs/id/manage-claude/compliance-errors#429-too-many-requests). Jika sesi lokal tidak tersedia untuk organisasi induk Anda, ketiga endpoint mengembalikan 404 dengan pesan `Local sessions are not available.` (lihat [Sesi lokal tidak ditemukan](https://platform.claude.com/docs/id/manage-claude/compliance-errors#local-session-not-found)); selama daftar sesi atau konten yang direkam untuk sementara tidak tersedia, endpoint tersebut mengembalikan 503 (lihat [Sesi lokal untuk sementara tidak tersedia](https://platform.claude.com/docs/id/manage-claude/compliance-errors#local-sessions-temporarily-unavailable)).
Untuk sesi lokal, Anthropic merekam setiap percakapan di sisi server saat permintaannya mencapai Claude API; tidak ada yang dipasang di perangkat, dan tidak ada yang dikumpulkan di luar permintaan yang sudah dikirim klien ke Claude API. Transkrip sesi lokal menunjukkan apa yang diminta dari Claude dan apa yang dikembalikannya, bukan apa yang terjadi di perangkat. Aktivitas file dan jaringan hanya terlihat melalui panggilan alat dan hasil alat dalam transkrip, sehingga aktivitas yang tidak pernah mencapai API (misalnya, file lokal yang tidak pernah dikirim oleh sesi) tidak direkam.
Di organisasi yang menggunakan ["customer-managed encryption keys" (kunci enkripsi yang dikelola pelanggan)](https://platform.claude.com/docs/id/manage-claude/cmek), transkrip sesi lokal dienkripsi dengan kunci yang dikelola pelanggan Anda dan dikembalikan seperti biasa. Selama kunci tersebut tidak dapat digunakan (misalnya, karena Anda menonaktifkan atau mencabutnya, atau karena kunci tersebut tidak dapat dijangkau), endpoint messages mengembalikan [503 Service Unavailable](https://platform.claude.com/docs/id/manage-claude/compliance-errors#local-sessions-temporarily-unavailable) untuk halaman yang terdampak alih-alih konten transkrip. Pesan-pesan tersebut tidak pernah dilaporkan sebagai `not_captured` (lihat [Mengambil transkrip sesi lokal](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-a-local-session-transcript)). Mencantumkan sesi dan mengambil metadata sesi tidak terpengaruh.
Endpoint list mengembalikan metadata sesi, tanpa konten transkrip, untuk setiap organisasi tertaut yang dapat dibaca oleh kunci Anda. Tidak seperti daftar sesi jarak jauh, endpoint ini tidak memiliki filter organisasi atau pengguna: batasi hasil berdasarkan waktu dengan `created_at.gte`, `created_at.gt`, `created_at.lt`, dan `created_at.lte`. Masing-masing menerima timestamp RFC 3339 dengan offset UTC yang wajib. Jika Anda memberikan batas bawah dan batas atas sekaligus, batas atas harus setelah batas bawah (atau sama dengannya, jika Anda menggunakan `created_at.gte` dengan `created_at.lte`), atau permintaan akan mengembalikan [400 Bad Request](https://platform.claude.com/docs/id/manage-claude/compliance-errors#400-bad-request). Filter waktu terpisah, `updated_at.gte`, membatasi berdasarkan aktivitas terakhir alih-alih aktivitas pertama: filter ini mengembalikan sesi yang panggilan inferensi terakhirnya terjadi pada atau setelah waktu yang diberikan dan dapat dikombinasikan dengan filter `created_at` tanpa mengubah urutan atau paginasi. Gunakan filter ini untuk melakukan polling sesi yang aktif sejak putaran sebelumnya, seperti yang dijelaskan nanti di bagian ini. Sesi dan pesan baru muncul dalam hasil setelah penundaan pemrosesan singkat, biasanya dalam hitungan menit; sesi yang tidak muncul segera setelah dimulai belum tentu tidak direkam. Permintaan berikut mencantumkan sesi yang dibuat sejak tanggal tertentu.
```bash cURL
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"
```
```json Response
{
"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"
}
```
Hasil diurutkan dalam urutan kronologis terbalik (terbaru lebih dulu) berdasarkan `created_at`, dengan nilai yang sama diurutkan menurut urutan tetap di sisi server, dan dibatasi hingga `limit` hasil per respons (default 100, maksimum 500). Endpoint ini hanya melakukan paginasi maju dengan token `page` dan `next_page` (lihat [Memaginasi hasil](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed#paginate-results)): kirimkan kembali nilai `next_page` dari respons sebagai parameter kueri `page` pada permintaan berikutnya, dan berhenti ketika `next_page` bernilai `null`. Respons tidak memiliki field `has_more`. Selesaikan penelusuran daftar dalam 24 jam sejak dimulai; kursor daftar yang lebih lama masih diterima tetapi dievaluasi ulang terhadap batas retensi saat ini, sehingga sesi yang aktivitas tertua yang dipertahankannya hampir melewati periode retensi dapat terlewati.
Dalam setiap objek sesi, `user.id` selalu diisi dan tetap ada meskipun akun dihapus; `user.email_address` bernilai `null` jika akun pengguna telah dihapus atau pengguna tidak lagi menjadi anggota organisasi yang dapat dibaca oleh kunci Anda. `workspace_id` bernilai `null` jika sesi tidak dikaitkan dengan workspace. Satu sesi lokal berkorespondensi dengan satu ID sesi klien: memulai percakapan baru di klien, atau menghapus konteksnya, akan memulai catatan sesi baru. Untuk Claude Science, daftar juga dapat menyertakan sesi terpisah untuk pekerjaan latar belakang aplikasi itu sendiri (misalnya, memberi nama percakapan; pada versi aplikasi yang lebih baru juga jalur peninjau dan delegasinya), dan pada versi aplikasi yang lebih lama sebagian pekerjaan latar belakang tersebut muncul sebagai pesan tambahan di dalam transkrip percakapan itu sendiri. Percakapan Claude Science yang berlanjut melewati beberapa pembaruan aplikasi muncul sebagai dua sesi. Perilaku ini memang diharapkan. Perlakukan nilai `id` sebagai string buram; formatnya dapat berubah tanpa pemberitahuan.
Untuk Claude for Microsoft 365, menghapus percakapan di add-in hanya terjadi di klien, sehingga tidak tercermin di API: sesi lokal tidak memiliki field `deleted_at`, dan sesi tetap tercantum hingga retensi menghapusnya.
Sesi lokal memiliki `updated_at` tetapi tidak memiliki `status`: sesi lokal tidak memiliki status siklus hidup di sisi server, dan visibilitasnya diatur oleh retensi. Sesi lokal direkam sebagai rangkaian panggilan Claude API (panggilan inferensi) yang dilakukan klien selama sesi, dan retensi berlaku untuk setiap panggilan yang direkam secara individual. `created_at` adalah timestamp panggilan tertua yang dipertahankan dalam sesi dan `updated_at` adalah timestamp panggilan terakhirnya, keduanya dalam UTC. Saat panggilan yang lebih lama melewati periode retensi, `created_at` bergeser maju sesuai dengan itu, dan setelah setiap panggilan dalam sesi melewati retensi, sesi tersebut tidak lagi dikembalikan; `updated_at` mengikuti panggilan terbaru dan tidak terpengaruh hingga saat itu. Karena `created_at` dapat bergeser di antara eksekusi, lakukan deduplikasi berdasarkan `id` saat Anda menelusuri ulang daftar dari waktu ke waktu. Agar transkrip tetap mutakhir saat sesi mendapatkan pesan baru, lakukan polling dengan filter `updated_at.gte`, dengan jendela berturut-turut yang saling tumpang tindih. Pada endpoint list, `updated_at` adalah batas bawah: untuk sesi yang masih aktif pada batas halaman atau pada ujung atas jendela `created_at`, nilainya dapat sesaat tertinggal dari aktivitas terakhir sesi yang sebenarnya, dan panggilan baru baru dapat dikueri setelah penundaan pemrosesan singkat yang disebutkan sebelumnya. Karena keterlambatan tersebut, tetapkan `updated_at.gte` setiap eksekusi beberapa menit sebelum waktu mulai eksekusi sebelumnya, bukan tepat pada waktu eksekusi sebelumnya. Batas yang ditetapkan tepat pada waktu sebelumnya akan secara diam-diam dan permanen melewatkan sesi yang panggilan terakhirnya masih diindeks pada saat itu, karena setelah batas bergeser melewati panggilan tersebut, tidak ada eksekusi berikutnya yang mengembalikannya. Lakukan deduplikasi sesi yang dikembalikan berdasarkan `id`, ambil ulang transkripnya, dan lakukan deduplikasi pesan berdasarkan `id`. Mengambil sesi, atau pesannya, selalu mencerminkan panggilan terbaru yang dipertahankan secara tepat, sehingga putaran rekonsiliasi berkala atas jendela yang lebih lama merupakan alternatif yang lebih menyeluruh dibandingkan memperlebar tumpang tindih.
Daftar dibangun dari metadata aktivitas sesi, sehingga dapat menyertakan sesi yang konten transkripnya tidak direkam, misalnya sesi yang berjalan sebelum perekaman dimulai untuk organisasi Anda (sejauh yang diizinkan oleh periode retensi Anda); transkrip sesi semacam itu mengembalikan setiap pesan dengan kontennya ditandai tidak tersedia (lihat [Mengambil transkrip sesi lokal](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-a-local-session-transcript)).
Konten sesi lokal yang direkam disimpan selama 6 tahun sejak perekaman secara default. Jika organisasi yang menjalankan sesi telah menetapkan periode retensi percakapan kustom yang terbatas di [claude.ai > Organization settings > Data and privacy](https://claude.ai/admin-settings/data-privacy-controls), periode tersebut yang berlaku, baik lebih pendek maupun lebih panjang dari default; jika organisasi memiliki lebih dari satu periode retensi kustom yang dikonfigurasi, periode terpendek yang berlaku. Perubahan pada pengaturan tersebut berlaku dengan dua cara berbeda: endpoint berhenti mengembalikan aktivitas yang lebih lama dari periode organisasi saat ini segera setelah pengaturan berubah, sedangkan setiap pesan yang direkam disimpan selama periode yang berlaku saat pesan tersebut direkam, sehingga memperpanjang periode di kemudian hari tidak memulihkan konten yang sudah kedaluwarsa. Di organisasi yang mengaktifkan [kesiapan HIPAA](https://platform.claude.com/docs/id/manage-claude/api-and-data-retention#hipaa-readiness), konten sesi lokal yang direkam disimpan selama 30 hari sejak perekaman, atau selama periode retensi percakapan kustom organisasi jika periode tersebut lebih pendek; default 6 tahun tidak berlaku.
Untuk mengambil metadata satu sesi secara langsung, berikan ID-nya ke `GET /v1/compliance/apps/sessions/local/{session_id}`. Responsnya adalah objek sesi yang sama dengan yang dikembalikan endpoint list, tanpa envelope dan tanpa konten transkrip. ID sesi yang formatnya salah mengembalikan [400 Bad Request](https://platform.claude.com/docs/id/manage-claude/compliance-errors#400-bad-request). Satu [404 Not Found](https://platform.claude.com/docs/id/manage-claude/compliance-errors#404-not-found) mencakup empat kasus yang tidak dibedakan oleh respons: sesi tidak berada di organisasi yang dapat dibaca oleh kunci Anda (termasuk sesi di bawah organisasi induk lain), sesi tidak ada, retensi data nol berlaku untuk sesi tersebut, atau setiap panggilan di dalamnya telah melewati retensi.
`product_surface` (string atau `null`) mengidentifikasi produk yang membuat sesi: `cowork` (Cowork di Claude Desktop pada mesin pengguna), `claude_code` (Claude Code), `claude_science` (Claude Science), `claude_in_chrome` (chat bawaan ekstensi browser Claude in Chrome), atau salah satu dari `office_agents/excel`, `office_agents/powerpoint`, `office_agents/word`, dan `office_agents/outlook` (Claude for Microsoft 365, per aplikasi; `office_agents` saja jika aplikasinya tidak teridentifikasi). Nilai baru muncul seiring perluasan cakupan.
**Bangun handler yang kompatibel ke depan.** Teruskan nilai `product_surface` yang tidak dikenali, dan abaikan field yang tidak diharapkan oleh handler Anda, agar integrasi Anda tetap berfungsi saat permukaan produk baru dirilis.
### Mengambil transkrip sesi lokal
Endpoint messages mengembalikan transkrip sesi, yang direkonstruksi dari panggilan Claude API yang direkam: prompt pengguna, teks asisten, panggilan alat, dan bagian teks dari hasil alat, semuanya dikembalikan sebagaimana dikirim kecuali pemotongan ukuran. Tidak ada yang menyamarkan URL, kredensial, atau data pribadi dalam konten tersebut, jadi perlakukan transkrip sebagai data sensitif. Transkrip menghilangkan atau mengganti hal-hal berikut:
* Blok thinking tidak pernah disertakan.
* "System prompt" (prompt sistem) dari permintaan tidak pernah dikembalikan. Pesan penanda yang berbunyi `[system prompt content not shown]` menggantikannya (biasanya sekali per sesi; sesi tanpa konten yang direkam tidak memiliki penanda).
* Definisi alat dan konfigurasi server "Model Context Protocol", atau MCP, bukan bagian dari transkrip.
* Gambar, PDF, dan blok biner atau terstruktur lainnya tidak dikembalikan. Masing-masing muncul sebagai blok `text` yang berbunyi `[ content not shown]` (misalnya, `[image content not shown]`) dengan `truncated` diatur ke `true`. Item non-teks di dalam hasil alat, seperti hasil [pencarian web](https://platform.claude.com/docs/id/agents-and-tools/tool-use/web-search-tool) atau output dari [alat eksekusi kode](https://platform.claude.com/docs/id/agents-and-tools/tool-use/code-execution-tool), diganti dengan satu entri `[N non-text item(s) not shown]`, dan `truncated` pada blok hasil alat bernilai `true`. Panggilan alat yang sesuai, dengan kueri pencarian atau kode dalam `input`-nya, tetap dikembalikan.
* Metadata sitasi pada blok `text`, seperti sitasi sumber pada jawaban yang memanfaatkan hasil pencarian web, dihilangkan. Teksnya sendiri dikembalikan, dan blok tersebut memiliki `truncated` yang diatur ke `true`.
File instruksi proyek seperti `CLAUDE.md` muncul sebagai konten peran pengguna biasa. Konten skill muncul ketika klien mengirimkannya sebagai konten pesan dan tidak dibedakan dari teks pengguna lainnya. Untuk ringkasan cakupan, lihat [FAQ Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-faq#data-coverage-and-retention); untuk tabel yang membandingkan sesi lokal dengan sesi jarak jauh dan logging OpenTelemetry, lihat pendahuluan halaman ini.
```bash cURL
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"
```
```json Response
{
"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
}
```
Respons menyematkan envelope `session` di samping array `data` yang dipaginasi. Catatan pertama dalam contoh ini adalah penanda yang menggantikan prompt sistem dari permintaan; `provenance`-nya dijelaskan nanti di bagian ini. Pada endpoint ini `user.email_address` selalu bernilai `null`: endpoint messages tidak me-resolve alamat email, sehingga `null` di sini tidak berarti akun pengguna telah dihapus. Untuk mengaitkan sesi dengan alamat email, gabungkan `user.id` dengan [endpoint list](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-local-sessions) atau endpoint retrieve (`GET /v1/compliance/apps/sessions/local/{session_id}`).
Pesan dikembalikan dari yang tertua lebih dulu secara default; berikan `order=desc` untuk membalik urutan. Paginasi menggunakan skema `page`/`next_page` yang sama dengan endpoint list, dengan `limit` default 100 dan maksimum 1.000. Sebuah halaman dapat berakhir lebih awal ketika respons mencapai batas ukurannya, sehingga halaman dengan pesan kurang dari `limit` tidak berarti Anda telah mencapai akhir; terus lakukan paginasi hingga `next_page` bernilai `null`. Kursor halaman terikat pada sesi dan urutan pengurutan saat kursor tersebut diterbitkan, dan kursor suatu penelusuran kedaluwarsa 24 jam setelah halaman pertamanya: kursor yang kedaluwarsa mengembalikan [400 Bad Request](https://platform.claude.com/docs/id/manage-claude/compliance-errors#400-bad-request) yang meminta Anda memulai ulang tanpa parameter `page`, dan penelusuran yang dimulai ulang mencerminkan batas retensi saat ini. Kursor yang diterbitkan untuk sesi atau `order` yang berbeda juga mengembalikan 400, sebagai kursor yang tidak valid.
Pada sesi yang sangat besar, endpoint messages dapat mengembalikan 400 untuk suatu halaman, dengan pesan yang menyatakan bahwa halaman tersebut terlalu besar untuk dibaca; lihat [Halaman transkrip terlalu besar](https://platform.claude.com/docs/id/manage-claude/compliance-errors#transcript-page-too-large). Jangan mencoba ulang permintaan tersebut. Jika permintaan tersebut menggunakan `order=desc`, baca sesi tersebut dari yang tertua lebih dulu mulai dari halaman pertamanya, tanpa `order` dan tanpa `page`, dan atur batas waktu permintaan klien Anda setidaknya 5 menit. Jika halaman dengan urutan tertua lebih dulu mengembalikan error yang sama, entri panduan error tersebut menjelaskan apa yang harus dilakukan.
Pada sesi yang sangat besar, endpoint messages juga mungkin mengembalikan 429 dengan `error.details.error_code` bernilai `transcript_read_server_busy`. Ini tidak berarti organisasi Anda melampaui batas laju. Tidak seperti 400, coba ulang permintaan ini: tunggu selama jumlah detik yang tertera di header `retry-after`, lalu kirim permintaan yang sama lagi tanpa perubahan (dengan nilai `page` yang sama, jika ada). Lihat [Server sibuk membaca transkrip besar](https://platform.claude.com/docs/id/manage-claude/compliance-errors#server-busy-reading-large-transcripts).
Setiap pesan memiliki `role` (`user` atau `assistant`) dan array `content` berisi blok `text`, `tool_use`, dan `tool_result`. Setiap pesan juga memiliki `model`: pada giliran asisten yang direkam dari Claude API, ini adalah model yang melayani giliran tersebut, dan nilainya `null` pada pesan pengguna dan pada pesan asisten mana pun yang `provenance`-nya diisi, karena riwayat yang dinyatakan klien dan penanda sintetis tidak dihasilkan oleh model, dan model yang melayani tidak diketahui untuk konten yang tidak tersedia. Blok `text` memiliki `text` dan `truncated`. Blok `tool_use` memiliki `id`, `name`, `input`, dan `truncated`, dengan `input` berupa string yang dienkode JSON, bukan objek. Blok `tool_result` memiliki `tool_use_id`, `name`, `is_error`, array `content` berisi entri `text`, dan `truncated`. Panggilan dan hasil alat MCP, serta sebagian besar panggilan dan hasil alat server, dinormalisasi ke dalam bentuk `tool_use` dan `tool_result` yang sama; jenis blok lainnya muncul sebagai placeholder `[ content not shown]`. `id` pesan bersifat stabil selama giliran tersebut dipertahankan. Setiap pesan yang direkonstruksi dari panggilan inferensi yang sama memiliki timestamp panggilan tersebut, sehingga pesan yang berurutan sering kali memiliki nilai `created_at` yang sama; pertahankan urutan yang dikembalikan alih-alih mengurutkan ulang berdasarkan timestamp.
Setiap pesan juga memiliki field `provenance` yang menjelaskan bagaimana kontennya direkam. `provenance` bernilai `null` untuk konten terverifikasi yang direkam oleh Claude API, yang merupakan kasus umum. Jika tidak, nilainya adalah objek yang `type`-nya menandai pengecualian:
* `content_unavailable` berarti konten tidak dapat dikembalikan. Array `content` kosong, dan `provenance.reason` menyatakan alasannya. `not_captured` berarti tidak ada konten yang tersedia untuk giliran tersebut. Ini tidak membuktikan bahwa tidak ada catatan yang disimpan: konten yang ditahan dari Compliance API oleh kebijakan penanganan data Anthropic dilaporkan dengan alasan yang sama, demikian pula giliran individual dalam sesi yang selebihnya direkam yang tidak tersedia karena alasan tersebut. Kunci yang dikelola pelanggan yang tidak dapat digunakan adalah satu-satunya pengecualian dan mengembalikan [503 Service Unavailable](https://platform.claude.com/docs/id/manage-claude/compliance-errors#local-sessions-temporarily-unavailable) sebagai gantinya. `client_aborted` berarti klien menutup koneksi atau membatalkan permintaan sebelum respons selesai, sehingga respons giliran tersebut tidak direkam; output parsial apa pun yang sudah di-stream ke klien tidak disertakan, dan alasan ini hanya berlaku untuk giliran peran asisten. `cmek_key_revoked` dicadangkan untuk konten yang dienkripsi dengan kunci yang dikelola pelanggan milik organisasi Anda ketika kunci tersebut tidak tersedia (misalnya, dicabut). Nilai ini saat ini tidak dikembalikan, karena kunci yang tidak dapat digunakan menghasilkan 503, tetapi tangani nilai ini untuk kompatibilitas ke depan. `retention_elapsed` berarti konten telah melewati retensi. `oversize` berarti satu pesan melampaui batas ukuran per pesan; pesan tersebut tetap dikembalikan, dengan array `content` yang kosong.
* `client_asserted` menandai pesan asisten yang diberikan klien sebagai riwayat percakapan dan tidak dapat dicocokkan dengan respons yang direkam; kepengarangannya tidak terverifikasi.
* `synthetic_marker` menandai catatan yang dihasilkan oleh endpoint itu sendiri, seperti penanda yang menggantikan prompt sistem. Ketika klien menulis ulang atau memadatkan riwayat percakapannya di tengah sesi (misalnya, setelah pemadatan konteks), transkrip menyisipkan pesan penanda pada titik tersebut dan melanjutkan dengan konten baru yang dikirim klien. Ketika organisasi Anda memiliki periode retensi yang terbatas dan konten baru tersebut menyertakan pesan asisten, transkrip menahan konten baru hingga dan termasuk pesan asisten terakhirnya (penanda kedua mencatat hal ini) dan hanya menampilkan pesan pengguna setelah titik tersebut, diikuti oleh sisa sesi.
Pesan penanda dan pesan yang dinyatakan klien diawali dengan blok `text` penjelasan dalam tanda kurung siku yang ditandai `truncated: true`, misalnya `[system prompt content not shown]`. Perlakukan catatan ini sebagai ada tetapi tidak tersedia atau tidak terverifikasi, bukan hilang, dan toleransi jenis dan alasan `provenance` yang tidak dikenali.
Dua parameter membatasi berapa banyak byte dari setiap blok alat yang dikembalikan: `tool_use_input_max_bytes` dan `tool_result_max_bytes`, keduanya default 10.000 byte. Berikan `-1` untuk maksimum server (sekitar 1 MiB per string); `0` mengembalikan [400 Bad Request](https://platform.claude.com/docs/id/manage-claude/compliance-errors#400-bad-request), dan nilai di atas maksimum dibatasi ke maksimum tersebut. String yang terpotong oleh salah satu batas dipotong pada batas karakter dan diberi sufiks in-band (misalnya, `…[truncated; pass tool_result_max_bytes=-1 for the server max]`), dan bloknya memiliki `"truncated": true`. Oleh karena itu, `input` `tool_use` yang terpotong bukan lagi JSON yang valid, jadi parse input alat hanya dari blok yang tidak terpotong (atau naikkan batasnya dan ambil ulang). Blok dengan jenis `text` selalu dibatasi pada maksimum server yang sama, yaitu sekitar 1 MiB; tidak ada parameter yang dapat menaikkannya, dan blok `text` yang mencapai batas tersebut juga memiliki `"truncated": true`.
Claude Science memanggil konektor (server MCP) dari kode yang dijalankannya melalui alat `repl`, bukan sebagai alat yang diberi nama terpisah, sehingga tidak ada blok dalam transkrip Claude Science yang dinamai sesuai konektor. Setiap panggilan konektor muncul dalam kode di dalam `input` blok `tool_use` `repl` (misalnya, panggilan `host.mcp("", "", ...)`), dan output konektor muncul di `tool_result` yang sesuai hanya jika kode tersebut mencetaknya. Sesi Cowork dan Claude Code berbeda: keduanya memanggil setiap alat konektor dengan namanya sendiri `mcp____`, yang merupakan `name` dari blok `tool_use`. Untuk memantau penggunaan konektor dalam sesi Claude Science, parse string `input` dan cocokkan berdasarkan kode yang dikandungnya, bukan berdasarkan nama alat. Berikan `tool_use_input_max_bytes=-1` untuk sesi ini agar input kode yang panjang dikembalikan hingga maksimum server alih-alih dipotong pada default 10.000 byte sebelum panggilan konektor muncul.
Konten transkrip mematuhi periode retensi yang dijelaskan di bagian [Sesi di mesin pengguna](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-local-sessions). Ketika awal sesi telah melewati periode tersebut, transkrip diawali dengan satu placeholder `content_unavailable` dengan `reason` bernilai `retention_elapsed`, diikuti oleh pesan-pesan yang dipertahankan. Ketika setiap panggilan dalam sesi telah melewati retensi, endpoint messages mengembalikan [404 Not Found](https://platform.claude.com/docs/id/manage-claude/compliance-errors#404-not-found), sama seperti untuk sesi di organisasi yang tidak dapat dibaca oleh kunci Anda, sesi yang tidak ada, dan sesi yang dikenai retensi data nol. ID sesi yang formatnya salah mengembalikan [400 Bad Request](https://platform.claude.com/docs/id/manage-claude/compliance-errors#400-bad-request).
## Sesi di cloud (sesi jarak jauh)
Sesi Cowork yang dimulai di claude.ai web atau seluler berjalan di cloud dalam lingkungan yang dikelola Anthropic. Compliance API mengekspos sesi jarak jauh ini melalui dua endpoint: `GET /v1/compliance/apps/sessions/remote` mencantumkan metadata sesi, dan `GET /v1/compliance/apps/sessions/remote/{session_id}/messages` mengembalikan transkrip satu sesi. Keduanya memerlukan cakupan `read:compliance_user_data`, dan keduanya dihitung terhadap batas laju Compliance API bersama ditambah anggaran permintaan kedua yang khusus untuk endpoint ini; lihat [429 Too Many Requests](https://platform.claude.com/docs/id/manage-claude/compliance-errors#429-too-many-requests).
Endpoint list secara default menggunakan cakupan seluruh organisasi: hilangkan `organization_ids[]` untuk menyertakan setiap organisasi claude.ai yang dapat dibaca oleh kunci Anda, atau berikan hingga 500 nilai untuk mempersempit cakupan. Untuk membatasi daftar ke pengguna tertentu, berikan 1–10 nilai `user_ids[]` (dapatkan ID dari [Daftar pengguna organisasi](https://platform.claude.com/docs/id/manage-claude/compliance-org-data#list-organization-users)); filter ini mencocokkan pengguna pemilik sesi, sehingga sesi milik agen dikecualikan setiap kali `user_ids[]` ditetapkan. Batasi hasil berdasarkan waktu dengan parameter rentang `created_at` (`gte`, `gt`, `lt`, `lte`, dalam format RFC 3339). Tidak ada filter `updated_at`. Permintaan berikut mencantumkan sesi yang dibuat sejak tanggal tertentu.
```bash cURL
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"
```
```json Response
{
"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"
}
```
Hasil diurutkan dalam urutan kronologis terbalik (terbaru lebih dulu) berdasarkan `created_at` dan dibatasi hingga `limit` hasil per respons (default 100, maksimum 500). Endpoint ini melakukan paginasi dengan token `page` dan `next_page` (lihat [Memaginasi hasil](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed#paginate-results)): berikan kembali nilai `next_page` dari respons sebagai parameter kueri `page` pada permintaan berikutnya, dan berhenti ketika `next_page` bernilai `null`.
Sebuah sesi dimiliki oleh pengguna atau agen, tidak pernah keduanya. Untuk sesi milik pengguna, `user` memuat ID dan alamat email pemilik (`email_address` bernilai `null` ketika pengguna tidak lagi menjadi anggota organisasi yang dapat dibaca oleh kunci Anda) dan `agent_id` bernilai `null`. Untuk sesi milik agen (misalnya, eksekusi tugas terjadwal Cowork di cloud), `user` bernilai `null`, `agent_id` memuat ID agen (awalan `cagt_`), dan `started_by_user` mengidentifikasi manusia yang memulai eksekusi tersebut; pada sesi milik pengguna, `started_by_user` bernilai `null`. Setiap eksekusi tugas terjadwal adalah sesi terpisah, dan tidak ada field sesi yang memuat nama atau jadwal tugas.
`claude_project_id` adalah ID [proyek](https://platform.claude.com/docs/id/manage-claude/compliance-content-data#retrieve-projects-and-attachments) claude.ai tempat sesi tersebut berada (awalan `claude_proj_`), atau `null` ketika sesi tidak berada dalam proyek.
`status` adalah salah satu dari `pending`, `active`, `paused`, `archived`, atau `failed`. Sebuah sesi berstatus `pending` selama sedang disiapkan; sesi `pending` belum memiliki transkrip, dan endpoint messages mengembalikan 404 untuknya hingga penyiapan selesai. Sesi yang telah dihapus tidak pernah dikembalikan.
`product_surface` (string atau `null`) mengidentifikasi produk yang membuat sesi. Endpoint ini saat ini hanya mengembalikan sesi dengan `product_surface` bernilai `cowork_remote`: sesi Cowork yang dimulai di claude.ai web atau seluler.
Untuk mengambil chat dalam pengalaman Claude terpadu, termasuk bagian yang berjalan di cloud, gunakan endpoint chat ([Mendapatkan pesan chat](https://platform.claude.com/docs/id/api/compliance/apps/chats/messages/list)), bukan endpoint sesi jarak jauh.
**Bangun handler yang kompatibel ke depan.** Teruskan nilai `status` dan `product_surface` yang tidak dikenali, dan abaikan field yang tidak diharapkan oleh handler Anda, sehingga integrasi Anda tetap berfungsi saat status dan permukaan produk baru dirilis.
### Mengambil transkrip sesi jarak jauh
Endpoint messages mengembalikan transkrip sesi: prompt pengguna, respons asisten, serta panggilan alat dan hasilnya. Blok thinking dan gambar tidak disertakan. Untuk ringkasan cakupan, lihat [FAQ Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-faq#data-coverage-and-retention); untuk tabel yang membandingkan sesi jarak jauh dengan sesi lokal dan logging OpenTelemetry Cowork, lihat pengantar halaman ini.
```bash cURL
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"
```
```json Response
{
"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
}
```
Respons menyematkan envelope `session` di samping array `data` yang dipaginasi. Pada endpoint ini envelope selalu memiliki `user.email_address`, `started_by_user`, dan `claude_project_id` bernilai `null`; dapatkan nilai-nilai tersebut dari endpoint list.
Pesan dikembalikan dari yang terlama lebih dulu secara default; teruskan `order=desc` untuk membalik urutan. Paginasi menggunakan skema `page`/`next_page` yang sama dengan endpoint list, dengan `limit` default 100 dan maks 1.000. Sebuah halaman dapat berakhir lebih awal ketika respons mencapai batas ukurannya, sehingga halaman dengan pesan kurang dari `limit` tidak berarti Anda telah mencapai akhir; teruslah melakukan paginasi hingga `next_page` bernilai `null`.
Setiap pesan memiliki `role` (`user` atau `assistant`) dan array `content` berisi blok `text`, `tool_use`, dan `tool_result`. Nilai `created_at` pesan adalah timestamp commit: pesan berurutan dapat berbagi timestamp atau sedikit terbalik, jadi pertahankan urutan yang dikembalikan alih-alih mengurutkan ulang berdasarkan `created_at`. Pada sesi milik agen, `sent_by_user_id` mencatat pengguna yang mengirim pesan pengguna tertentu ketika dapat diatribusikan; nilainya `null` jika tidak, termasuk pada semua pesan asisten. Ketika konten pesan tidak dapat dikembalikan sama sekali (misalnya, melebihi batas ukuran), pesan memiliki `content_unavailable` diatur ke `true`.
Dua parameter membatasi berapa byte dari setiap blok alat yang dikembalikan: `tool_use_input_max_bytes` dan `tool_result_max_bytes`, keduanya default 10.000 byte. Teruskan `-1` untuk maksimum server (sekitar 1 MiB per string); `0` mengembalikan [400 Bad Request](https://platform.claude.com/docs/id/manage-claude/compliance-errors#400-bad-request). Blok yang terpotong oleh salah satu batas memiliki `"truncated": true`, dan input `tool_use` yang terpotong bukan lagi JSON yang valid, jadi parse input alat hanya dari blok yang tidak terpotong (atau naikkan batasnya dan ambil ulang).
Endpoint messages mengembalikan [404 Not Found](https://platform.claude.com/docs/id/manage-claude/compliance-errors#404-not-found) untuk sesi `pending`, sesi yang tidak ada atau telah dihapus, dan sesi di organisasi yang tidak dapat dibaca kunci Anda.
## Retensi dan penghapusan
Endpoint sesi bersifat hanya-baca; sesi lokal dan jarak jauh tidak dapat dihapus melalui Compliance API. Transkrip sesi lokal disimpan selama 6 tahun secara default, atau sesuai periode retensi percakapan kustom organisasi Anda ketika periode terbatas ditetapkan, atau 30 hari di organisasi dengan kesiapan HIPAA diaktifkan, seperti dijelaskan di bagian [Sesi di mesin pengguna](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-local-sessions). Transkrip sesi jarak jauh disimpan selama 6 tahun, kecuali pengguna menghapus sesi lebih awal. Endpoint sesi jarak jauh tidak lagi mengembalikan sesi setelah pengguna menghapusnya, dan transkripnya tidak dapat dipulihkan melalui Compliance API. Untuk mempelajari bagaimana periode ini berdampingan dengan pengaturan retensi Anthropic lainnya, lihat [API dan retensi data](https://platform.claude.com/docs/id/manage-claude/api-and-data-retention).
## Langkah selanjutnya
Akses konten chat claude.ai, lampiran file, dan proyek dengan Compliance Access Key yang sama.
Ringkasan per bidang tentang apa saja yang tercakup dalam transkrip sesi, serta pertanyaan umum lainnya.
Payload error secara verbatim dan perbaikan untuk masing-masingnya.
Path endpoint, parameter, dan skema respons untuk Compliance API.