Menangani error Compliance API

Halaman ini mencantumkan pesan respons yang dikembalikan oleh setiap endpoint Compliance API yang terdokumentasi, penyebabnya, dan perbaikannya.

Compliance API mengembalikan error dalam format error Anthropic standar: kode status non-2xx, header respons request-id, dan body JSON dengan objek error yang berisi type dan message. Sertakan nilai header request-id saat Anda mengeskalasi ke dukungan.

{
  "error": {
    "type": "authentication_error",
    "message": "The API key provided is invalid or has been revoked."
  }
}

Di halaman ini, sesi lokal berjalan di mesin pengguna dan sesi remote berjalan di cloud; lihat Mengambil transkrip sesi.

Cocokkan berdasarkan error.type, bukan berdasarkan string pesan. Pesan cukup stabil untuk disalin ke dalam runbook tetapi mungkin diubah susunan katanya seiring waktu; nilai type adalah bagian dari kontrak API. Endpoint sesi lokal memiliki beberapa pengecualian terdokumentasi di mana respons yang berbagi type yang sama dibedakan berdasarkan pesannya; masing-masing disebutkan di tempat yang berlaku.

Tabel berikut memberi tahu Anda secara sekilas apakah perlu mencoba ulang. Setiap bagian selanjutnya menampilkan body error secara verbatim dan perbaikannya.

400 Bad Request

Permintaan valid secara sintaksis tetapi berisi parameter yang ditolak server. Perbaiki parameter dan coba ulang.

Format timestamp tidak valid

Type: invalid_request_error

The `created_at.gte` parameter contains an invalid timestamp format. Timestamps must be provided in RFC 3339 format e.g., "2024-03-01T00:00:00Z". Got "2024-01-01".

Penyebab: Nilai created_at.* atau updated_at.* (.gte, .gt, .lte, .lt) tidak dapat di-parse sebagai datetime. Pesan menyebutkan parameter yang gagal dan menampilkan kembali nilai yang dikirim.

Perbaikan: Kirim timestamp RFC 3339 lengkap termasuk waktu dan zona waktu, misalnya, 2024-03-01T00:00:00Z atau 2024-03-01T00:00:00+00:00.

List sesi lokal (GET /v1/compliance/apps/sessions/local) juga mengembalikan 400 invalid_request_error ketika kedua batas waktu diberikan dan created_at.lt tidak benar-benar setelah created_at.gte. Body-nya berbunyi:

created_at.lt must be strictly after created_at.gte.

Kirim created_at.lt yang lebih lambat dari created_at.gte, atau hilangkan salah satu batas.

Limit tidak valid

Type: invalid_request_error

The limit parameter must be between 1 and 1000, inclusive. Got 1500.

Penyebab: Parameter query limit berada di luar rentang yang diterima. Batas yang disebutkan dalam pesan mencerminkan maksimum untuk endpoint spesifik yang dipanggil.

Perbaikan: Kirim limit dalam rentang yang diterima endpoint. Setiap endpoint list memiliki rentang limit sendiri; lihat batasan parameter pada halaman referensi Compliance API yang sesuai.

Endpoint transkrip sesi (GET /v1/compliance/apps/sessions/local/{session_id}/messages dan GET /v1/compliance/apps/sessions/remote/{session_id}/messages) memvalidasi parameter pemotongannya dengan cara yang sama: tool_use_input_max_bytes dan tool_result_max_bytes masing-masing menerima jumlah byte positif atau -1 (maksimum server), sehingga nilai seperti 0 mengembalikan 400 invalid_request_error yang sama.

ID paginasi tidak valid

Type: invalid_request_error

Invalid `after_id`. No activity found for `after_id` "activity_invalid123"

Penyebab: Cursor after_id atau before_id tidak dapat di-decode sebagai cursor opaque atau di-parse sebagai ID aktivitas.

Perbaikan: Perlakukan cursor paginasi sebagai string opaque. Selalu salin nilai first_id atau last_id yang dikembalikan oleh halaman sebelumnya; berhenti ketika has_more bernilai false. Jangan menyusun cursor dari ID objek.

Endpoint direktori, proyek, dan sesi (organizations, users, roles, role permissions, groups, group members, projects, project attachments, sesi lokal dan remote, serta session messages) melakukan paginasi dengan token page opaque, bukan after_id dan before_id. Saran yang sama berlaku: teruskan nilai next_page dari respons sebelumnya tanpa diubah, dan berhenti ketika has_more bernilai false (atau, pada endpoint sesi, yang tidak mengembalikan has_more, ketika next_page bernilai null). Token page yang rusak mengembalikan 400 invalid_request_error yang sama seperti after_id atau before_id yang rusak.

Dua endpoint sesi lokal yang berpaginasi (endpoint list dan messages) mengembalikan 400 invalid_request_error berikut untuk nilai page apa pun yang tidak dapat di-decode, misalnya, token yang terpotong atau diubah setelah Anda menyimpannya, atau yang diterbitkan oleh endpoint berbeda atau di bawah organisasi induk berbeda. Pada endpoint messages sesi lokal (GET /v1/compliance/apps/sessions/local/{session_id}/messages), setiap cursor page juga terikat pada sesi dan order tempat cursor itu diterbitkan, sehingga cursor yang diterbitkan untuk sesi atau urutan sortir berbeda mengembalikan body yang sama:

The page parameter is not a valid cursor for this request.

Cursor pada endpoint messages juga kedaluwarsa 24 jam setelah walk (satu kali penelusuran melalui halaman-halaman) dimulai. Cursor yang kedaluwarsa mengembalikan:

The page cursor has expired. Restart the walk without a page parameter; results will reflect the current retention boundary.

Untuk body pertama, kirim ulang nilai next_page yang tidak dimodifikasi dari respons sebelumnya ke endpoint dan sesi yang menerbitkannya. Untuk cursor yang kedaluwarsa, mulai ulang tanpa parameter page; walk baru mencerminkan batas retensi yang berlaku saat dimulai, sehingga pesan yang telah melewati periode retensi dalam rentang waktu tersebut tidak lagi dikembalikan (lihat Mengambil transkrip sesi lokal).

401 Unauthorized

Header x-api-key tidak ada atau tidak cocok dengan kunci yang dikenal. Kunci valid dengan scope yang salah mengembalikan 403 Forbidden sebagai gantinya.

Kunci API tidak valid

Type: authentication_error

The API key provided is invalid or has been revoked.

Penyebab: Kunci dalam x-api-key tidak ada, telah dihapus, atau telah dinonaktifkan. Header x-api-key yang tidak ada atau kosong mengembalikan body yang sama, jadi periksa baik penyimpanan rahasia Anda maupun status pencabutan kunci tersebut.

Perbaikan: Konfirmasi nilai kunci, periksa bahwa kunci belum dihapus di claude.ai (Compliance Access Keys) atau Claude Console (kunci Admin API), dan konfirmasi bahwa kunci diaktifkan. Lihat Menyiapkan Compliance API.

403 Forbidden

Kunci dalam x-api-key valid tetapi tidak membawa scope yang diperlukan endpoint. Pesan verbatim mencantumkan scope yang dibawa kunci (Got:) dan scope yang diperlukan endpoint (Needed:), sehingga Anda dapat mengonfirmasi apa yang dibawa kunci tanpa memeriksa ulang Claude Console atau claude.ai. Scope Compliance Access Key tidak dapat diubah setelah pembuatan, sehingga setiap perbaikan scope-tidak-memadai mengarahkan Anda untuk membuat kunci baru alih-alih mengedit yang sudah ada. Organisasi Claude Console mandiri (yang tidak memiliki organisasi induk) tidak dapat membuat Compliance Access Key, sehingga perbaikan yang memerlukannya tidak berlaku untuknya; organisasi tersebut hanya dapat melakukan query Activity Feed.

Scope tidak memadai: Activity Feed

Type: permission_error

Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_activities']

Penyebab: Kunci tanpa read:compliance_activities digunakan untuk memanggil GET /v1/compliance/activities. Ada dua jalur umum menuju error ini:

• Compliance Access Key (sk-ant-api01-...) dibuat tanpa scope read:compliance_activities.
• Kunci Admin API Claude Console (sk-ant-admin01-...) dibuat saat Compliance API belum diaktifkan untuk organisasi. Kunci yang dibuat saat Compliance API belum diaktifkan tidak membawa scope tersebut; lihat Menyiapkan Compliance API.

Perbaikan: Scope Compliance Access Key tidak dapat diubah setelah pembuatan. Buat kunci baru yang menyertakan read:compliance_activities, atau gunakan kunci Admin API Claude Console. Lihat Kunci mana yang Anda perlukan? untuk kondisi di mana kunci Admin API membawa scope ini.

Scope tidak memadai: data organisasi

Type: permission_error

Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_org_data']

Penyebab: Kunci tanpa read:compliance_org_data digunakan untuk memanggil endpoint organizations, roles, groups, atau effective-settings. Ada dua jalur umum menuju error ini:

• Compliance Access Key (sk-ant-api01-...) dibuat tanpa scope read:compliance_org_data.
• Kunci Admin API Claude Console (sk-ant-admin01-...) digunakan. Kunci Admin API hanya membawa read:compliance_activities dan tidak dapat membaca metadata organisasi.

Perbaikan: Buat Compliance Access Key baru dengan read:compliance_org_data dipilih. Kunci Admin API tidak dapat membaca metadata organisasi; Compliance Access Key diperlukan.

Scope yang dipensiunkan: pengaturan organisasi

Type: permission_error

Missing required scopes. Got: ['read:compliance_org_settings'] Needed: ['read:compliance_org_data']

Penyebab: Scope read:compliance_org_settings dipensiunkan pada 30 Juni 2026. GET /v1/compliance/organizations/{organization_id}/settings kini memerlukan read:compliance_org_data, scope yang sama dengan endpoint organisasi lainnya, dan scope yang dipensiunkan tidak lagi mengotorisasi apa pun. Compliance Access Key yang hanya membawa read:compliance_org_settings mengembalikan error ini pada setiap panggilan ke endpoint settings, meskipun kunci tersebut berfungsi sebelum pemensiunan. Scope yang dipensiunkan tidak dapat lagi dipilih atau diberikan saat membuat kunci.

Perbaikan: Scope Compliance Access Key tidak dapat diubah setelah pembuatan. Buat Compliance Access Key baru dengan read:compliance_org_data dipilih, perbarui integrasi Anda untuk menggunakannya, lalu hapus kunci lama. Kunci yang sudah membawa read:compliance_org_data tidak terpengaruh oleh pemensiunan ini.

Scope tidak memadai: data pengguna

Type: permission_error

Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']

Penyebab: Kunci tanpa read:compliance_user_data digunakan untuk memanggil endpoint chats, messages, files, projects, sessions, organization users, atau group-members. Ada dua jalur umum menuju error ini:

• Compliance Access Key (sk-ant-api01-...) dibuat tanpa scope read:compliance_user_data.
• Kunci Admin API Claude Console (sk-ant-admin01-...) digunakan. Kunci Admin API hanya membawa read:compliance_activities dan tidak dapat diberikan read:compliance_user_data, sehingga tidak dapat memanggil endpoint chat, file, project, project attachment, session, user, atau group-member.

Perbaikan: Gunakan Compliance Access Key yang dibuat di claude.ai dengan read:compliance_user_data dipilih. Jika permintaan memang seharusnya hanya untuk Activity Feed, arahkan kunci Admin API ke GET /v1/compliance/activities sebagai gantinya.

Scope tidak memadai: delete

Type: permission_error

Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['delete:compliance_user_data']

Penyebab: Compliance Access Key tanpa delete:compliance_user_data digunakan untuk memanggil endpoint DELETE pada chats, files, atau projects.

Perbaikan: Buat Compliance Access Key baru dengan delete:compliance_user_data dipilih. Scope delete terpisah dari read:compliance_user_data agar kunci audit read-only tidak dapat menghapus konten.

404 Not Found

Endpoint berhasil di-resolve tetapi ID resource tidak ada atau sudah dihapus. Penghapusan Compliance API bersifat langsung dan permanen, sehingga 404 pada ID yang sebelumnya dikenal biasanya berarti konten telah di-hard-delete melalui panggilan delete Compliance API atau dihapus oleh kebijakan retensi. Endpoint sesi menambahkan dua kasus. Pada endpoint sesi lokal, pesan 404 terpisah, Local sessions are not available., dikembalikan pada setiap panggilan (termasuk list) selama endpoint tidak tersedia untuk organisasi induk Anda; pesan ini tidak bergantung pada ID sesi dan dapat bersifat sementara. Lihat Sesi lokal tidak ditemukan. Pada endpoint sesi remote, sesi yang masih dalam proses provisioning (status bernilai pending) belum memiliki transkrip, sehingga endpoint messages-nya mengembalikan 404 hingga sesi dimulai. Lihat Sesi remote tidak ditemukan. String activity-type yang dikutip dalam setiap Perbaikan (misalnya, claude_chat_created) adalah nilai yang dapat Anda teruskan ke filter activity_types[] Activity Feed; lihat Query aktivitas kepatuhan untuk setiap nilai yang didukung.

Chat tidak ditemukan

Type: not_found_error

Chat claude_chat_01H5CWunD7RpVJ5bHa8RCkja not found.

Penyebab: ID chat dalam path tidak cocok dengan chat yang dapat dibaca melalui Compliance API. Chat mungkin telah di-hard-delete melalui panggilan Compliance API sebelumnya atau dihapus oleh kebijakan retensi organisasi Anda, atau mungkin milik organisasi yang tidak dapat dibaca oleh kunci pemanggil. Chat yang dihapus pengguna di claude.ai tidak mengembalikan 404; chat tersebut tetap dapat dibaca, dengan deleted_at terisi, tetapi tanpa konten pesannya.

Perbaikan: Konfirmasi ID chat terhadap aktivitas claude_chat_created atau claude_chat_viewed terbaru. Jika aktivitasnya baru dan pembacaan masih gagal, chat telah di-hard-delete (melalui API ini atau karena kedaluwarsa kebijakan retensi) atau milik organisasi di luar scope kunci Anda.

File tidak ditemukan

Type: not_found_error

No file found with provided id, or it has already been deleted.

Penyebab: ID file tidak ada atau telah dihapus. Error ini berlaku untuk file yang dilampirkan ke chat (claude_file_...) maupun file proyek.

Perbaikan: Rekonsiliasi terhadap aktivitas claude_file_uploaded atau claude_file_deleted terbaru. Jika file telah dihapus, binernya sudah hilang; catatan aktivitas tetap ada di feed selama jendela retensi 6 tahun.

Proyek tidak ditemukan

Type: not_found_error

No project is found with the provided id.

Penyebab: ID proyek tidak ada atau telah dihapus.

Perbaikan: Rekonsiliasi terhadap aktivitas claude_project_created atau claude_project_deleted terbaru. Activity Feed terus menampilkan peristiwa siklus hidup proyek bahkan setelah proyek itu sendiri hilang.

Dokumen proyek tidak ditemukan

Type: not_found_error

No project document found with provided id, or it has already been deleted.

Penyebab: ID dokumen proyek tidak ada atau telah dihapus. Error ini berlaku untuk dokumen proyek teks (claude_proj_doc_...), bukan untuk file proyek.

Perbaikan: Gunakan GET /v1/compliance/apps/projects/{project_id}/attachments untuk mencantumkan lampiran saat ini. Jika dokumen tidak ada, dokumen tersebut telah dihapus; ambil melalui catatan aktivitas claude_project_document_uploaded jika Anda hanya memerlukan metadatanya.

Sesi lokal tidak ditemukan

Type: not_found_error

Local session not found.

Penyebab: ID sesi yang diteruskan ke GET /v1/compliance/apps/sessions/local/{session_id} atau GET /v1/compliance/apps/sessions/local/{session_id}/messages tidak cocok dengan sesi lokal yang dapat dibaca melalui Compliance API. Kedua endpoint mengembalikan satu pesan ini, tanpa membedakan penyebabnya, ketika ID bukan sesi dalam organisasi yang dapat dibaca kunci Anda (termasuk ID yang milik organisasi induk lain), ketika sesi tidak pernah ada, ketika zero data retention berlaku untuk sesi tersebut, atau ketika semua aktivitas sesi telah melewati periode retensi yang berlaku untuk organisasi yang menjalankannya. Respons Local session not found. tidak memiliki bentuk sementara, karena sesi lokal tidak memiliki status provisioning (pending); bandingkan dengan Sesi remote tidak ditemukan, di mana sesi pending mengembalikan 404 hingga dimulai. ID sesi yang bukan pengenal clls_ yang terbentuk dengan benar mengembalikan 400 Bad Request sebagai gantinya.

Endpoint sesi lokal, termasuk endpoint list, mengembalikan pesan 404 yang berbeda, Local sessions are not available., selama endpoint itu sendiri tidak tersedia untuk organisasi induk Anda. Respons tersebut tidak bergantung pada ID sesi; tidak ada kunci, scope, atau pengaturan di sisi pelanggan yang mengubahnya, dan respons ini dapat bersifat sementara. Kedua respons membawa type not_found_error; teks pesanlah yang membedakannya.

Perbaikan: Konfirmasi ID sesi terhadap GET /v1/compliance/apps/sessions/local; lihat Sesi di mesin pengguna. Jika sesi tidak lagi muncul dalam list, kontennya telah melewati retensi (atau sesi tersebut tidak lagi berada dalam organisasi yang dapat dibaca kunci Anda) dan transkripnya tidak dapat diambil; hapus ID dari antrean Anda. Jika setiap panggilan, termasuk list, mengembalikan Local sessions are not available., simpan ID sesi yang Anda antrekan dan coba ulang pada jadwal berikutnya; jika respons berlanjut, hubungi perwakilan Anthropic Anda dan sertakan header respons request-id.

Sesi remote tidak ditemukan

Type: not_found_error

Remote session not found.

Penyebab: ID sesi yang diteruskan ke GET /v1/compliance/apps/sessions/remote/{session_id}/messages tidak cocok dengan transkrip sesi yang dapat dibaca melalui Compliance API. Ini terjadi ketika ID sesi (cse_...) tidak ada atau sesi telah dihapus, ketika sesi milik organisasi yang tidak dapat dibaca kunci Anda, atau ketika status sesi masih pending: sesi pending belum memiliki transkrip, sehingga endpoint messages mengembalikan 404 hingga sesi dimulai. ID sesi yang bukan pengenal cse_ yang terbentuk dengan benar mengembalikan 400 Bad Request sebagai gantinya.

Perbaikan: Konfirmasi ID sesi dan status-nya terhadap GET /v1/compliance/apps/sessions/remote; lihat Sesi di cloud. Jika sesi pending, coba ulang setelah sesi meninggalkan status tersebut. Jika sesi tidak lagi muncul dalam list, sesi telah dihapus dan transkripnya tidak dapat diambil.

Organisasi, role, atau group tidak ditemukan

Type: not_found_error

The "ce86b5f3-7c16-48b3-a9f3-e1d2c4b8a0f1" organization does not exist or the requester is not authorized to access it.

Endpoint organization, role, dan group mengembalikan 404 not_found_error dalam format error standar. Pesan organisasi menyebutkan org_uuid; pesan role dan group bersifat generik (Role not found., Group not found.). Ini terjadi ketika ID path (org_uuid, role_id, atau group_id) tidak ada atau tidak lagi termasuk dalam tree yang dapat dibaca kunci pemanggil.

Penyebab: ID dalam path tidak cocok dengan catatan yang dapat dibaca melalui Compliance API. Role dan group dapat dihapus, dan organisasi dapat dilepas tautannya dari tree induk.

Perbaikan: Verifikasi ID terhadap endpoint list yang sesuai, dan rekonsiliasi terhadap aktivitas organisasi, role, atau group terbaru di Activity Feed.

Pengaturan organisasi tidak tersedia

Type: not_found_error

organization `91012d09-e48b-438e-a489-1bebfd8fa6f9` not found in this organization's hierarchy

Penyebab: GET /v1/compliance/organizations/{organization_id}/settings mengembalikan 404 ini dalam tiga kasus yang sengaja berbagi body yang sama agar respons tidak mengungkapkan apakah suatu organisasi ada: organization_id bukan salah satu organisasi tertaut milik induk Anda, nilainya bukan UUID yang valid, atau endpoint settings belum diaktifkan untuk organisasi induk Anda.

Perbaikan: Verifikasi ID terhadap List organizations. Jika ID organisasi yang diketahui benar masih mengembalikan 404, endpoint settings belum diaktifkan untuk organisasi induk Anda; hubungi perwakilan Anthropic Anda.

409 Conflict

Permintaan terbentuk dengan benar dan terotorisasi tetapi bertentangan dengan status resource saat ini.

Proyek memiliki chat terlampir

Type: conflict_error

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.

Penyebab: DELETE /v1/compliance/apps/projects/{project_id} dipanggil pada proyek yang masih memiliki chat terlampir.

Perbaikan: Cantumkan chat proyek dengan GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id} (filter project_ids[] memerlukan setidaknya satu nilai user_ids[]; enumerasi ID melalui List organization users), hapus masing-masing dengan DELETE /v1/compliance/apps/chats/{claude_chat_id}, lalu coba ulang penghapusan proyek.

429 Too Many Requests

Permintaan ke Compliance API dibatasi hingga 600 permintaan per menit per organisasi induk. "Rate limit" (batas laju) ini adalah satu anggaran yang dibagi di seluruh kunci di bawah induk (Compliance Access Keys dan kunci Admin API dari semua organisasi tertaut) dan di seluruh endpoint /v1/compliance/*; endpoint sesi remote membawa anggaran permintaan kedua di atasnya. Untuk organisasi Claude Console mandiri, yang tidak memiliki organisasi induk, anggaran yang sama berlaku untuk organisasi itu sendiri dan dibagi di seluruh kunci Admin API-nya. Hubungi perwakilan Anthropic Anda jika integrasi Anda memerlukan batas yang lebih tinggi.

Setelah kunci API Anda terautentikasi, respons Compliance API melaporkan anggaran bersama melalui header respons batas laju standar sehingga klien Anda dapat melakukan throttle secara proaktif alih-alih menunggu 429:

• anthropic-ratelimit-requests-limit adalah anggaran permintaan per menit.
• anthropic-ratelimit-requests-remaining adalah anggaran yang tersisa dalam jendela saat ini.
• anthropic-ratelimit-requests-reset adalah timestamp RFC 3339 saat jendela direset dan anggaran penuh dipulihkan.

Respons 429 juga membawa header retry-after dengan jumlah detik yang harus ditunggu sebelum mengirim permintaan berikutnya. Nilai ini mungkin menyertakan margin keamanan kecil di luar anthropic-ratelimit-requests-reset; patuhi retry-after.

HTTP/1.1 429 Too Many Requests
date: Tue, 21 Apr 2026 14:38:02 GMT
retry-after: 25
anthropic-ratelimit-requests-limit: 600
anthropic-ratelimit-requests-remaining: 0
anthropic-ratelimit-requests-reset: 2026-04-21T14:38:25Z

{
  "error": {
    "type": "rate_limit_error",
    "message": "Compliance API rate limit of 600 requests per minute per parent organization has been exceeded. Retry after the time indicated by the retry-after header. Quote the request-id response header when contacting Anthropic support."
  }
}

Penyebab: Organisasi induk Anda (atau organisasi Claude Console mandiri) mengirim lebih dari 600 permintaan ke /v1/compliance/* dalam jendela 1 menit, di seluruh kunci yang berbagi anggarannya, atau telah menghabiskan anggaran permintaan kedua endpoint sesi remote (dijelaskan nanti di bagian ini).

Perbaikan: Tunggu sejumlah detik dalam header retry-after, lalu coba ulang. Jika header tidak ada (misalnya, dihapus oleh perantara), gunakan exponential backoff sebagai cadangan (mulai dari 1 detik, gandakan hingga 60 detik). Jangan majukan cursor paginasi Anda pada 429: permintaan yang gagal tidak mengembalikan data, sehingga cursor dari halaman terakhir yang berhasil masih benar.

Permintaan yang gagal autentikasi (kunci yang tidak ada atau tidak dikenal, atau kunci Claude API alih-alih Compliance Access Key atau kunci Admin API) ditolak sebelum rate limiter dan tidak mengonsumsi kuota. Kunci valid yang tidak memiliki scope yang diperlukan endpoint mengonsumsi satu unit kuota sebelum 403 dikembalikan.

Endpoint sesi lokal hanya dihitung terhadap batas bersama. Endpoint sesi remote juga membawa anggaran permintaan kedua, yang dikunci ke organisasi induk Anda seperti batas bersama, di atasnya. 429 dari anggaran tersebut membawa header retry-after yang selalu bernilai 1 (waktu tunggu minimum, bukan waktu reset sebenarnya); header anthropic-ratelimit-* apa pun pada respons tersebut menjelaskan batas bersama, bukan anggaran ini, jadi lakukan backoff secara eksponensial jika 429 berulang.

Jika Anda melakukan polling Activity Feed secara terjadwal, anggarkan laju permintaan agregat Anda (di seluruh kunci, organisasi tertaut, dan worker konkuren) di bawah batas bersama. Pantau anthropic-ratelimit-requests-remaining untuk memperlambat sebelum Anda mencapainya. Lihat Merancang integrasi kepatuhan Anda untuk memilih antara window-polling dan ingestion berbasis cursor.

500 Internal Server Error

500 dari Compliance API membawa header respons x-should-retry: false ketika kegagalannya deterministik. SDK Anthropic mematuhi header ini secara otomatis. Jika Anda menggunakan library retry HTTP generik yang mencoba ulang pada setiap 5xx, tekan retry ketika x-should-retry bernilai false; mencoba ulang error ini gagal secara identik pada setiap percobaan.

500 tanpa header x-should-retry: false bersifat sementara: coba ulang dengan exponential backoff (mulai dari 1 detik, gandakan hingga 60 detik). Hal yang sama berlaku untuk respons 502, 503, 504, dan 529. Pengecualiannya adalah sekumpulan kecil 503 sesi lokal, yang dijelaskan berikutnya, yang bergantung pada pengaturan atau kunci enkripsi organisasi, bukan pada beban. Lihat Errors untuk semantik retry di seluruh platform.

Sesi lokal sementara tidak tersedia

Type: overloaded_error

The local-sessions index is temporarily unavailable. Try again shortly.

Captured content is temporarily unavailable. Try again shortly.

The local-sessions index cannot currently evaluate retention overrides for this page. Try again later.

Penyebab: Endpoint sesi lokal mengembalikan 503 dengan salah satu body ini. Ketiganya berbagi type overloaded_error, sehingga ini adalah salah satu dari sedikit error di halaman ini di mana Anda memerlukan teks pesan, bukan error.type, untuk membedakan kondisinya:

• Body index is temporarily unavailable berarti daftar sesi sementara tidak tersedia karena beban atau kondisi back-end. Ini bersifat sementara.
• Body Captured content berarti konten transkrip sesi tidak dapat dikembalikan saat ini. Ini biasanya juga bersifat sementara. Dalam organisasi yang menggunakan kunci enkripsi yang dikelola pelanggan, endpoint messages juga mengembalikan body ini untuk setiap halaman yang berisi konten yang tidak dapat didekripsi oleh kunci Anda, misalnya karena Anda menonaktifkan, mencabut, atau menghancurkan kunci, atau karena kunci tidak dapat dijangkau. Dalam kasus tersebut error berlanjut selama kunci tidak dapat digunakan. Teks pesannya sama dalam kedua kasus, sehingga satu-satunya sinyal bahwa kunci adalah penyebabnya adalah error terus berulang untuk organisasi tersebut. Kunci yang tidak dapat digunakan tidak pernah dilaporkan sebagai not_captured.
• Body retention overrides berarti pengaturan retensi atau penanganan data yang berlaku untuk satu atau lebih sesi dalam rentang yang diminta belum dapat dievaluasi. Pada endpoint retrieve dan messages, body ini berbunyi for this session alih-alih for this page. Body ini bergantung pada data dan pengaturan organisasi yang menjalankan sesi, bukan pada beban, dan dapat berlanjut untuk periode yang lama.

Perbaikan: Tangani setiap body sebagai berikut:

• Untuk dua body Try again shortly., coba ulang dengan exponential backoff dan jangan majukan cursor page Anda, karena permintaan yang gagal tidak mengembalikan data.
• Jika body Captured content terus berulang pada endpoint messages untuk organisasi yang menggunakan kunci yang dikelola pelanggan, perlakukan sebagai persisten: hentikan penelusuran transkrip organisasi tersebut dan periksa status kunci di layanan manajemen kunci Anda. Transkrip di organisasi tertaut lainnya, dan metadata sesi di mana pun, tidak terpengaruh. Jika Anda mencoba ulang pada jadwal berikutnya, mulai ulang walk setiap sesi tanpa page, karena cursor halaman messages kedaluwarsa 24 jam setelah halaman pertama walk.
• Untuk body Try again later., jangan biarkan walk tetap terbuka menunggu kondisi ini hilang. Pada endpoint list, coba ulang nanti dengan memulai ulang tanpa parameter page (token halaman list yang lebih lama dari 24 jam masih diterima tetapi dievaluasi ulang terhadap batas retensi saat ini, sehingga walk yang diparkir dapat melewatkan sesi), atau persempit jendela created_at.gte dan created_at.lt hingga permintaan berhasil dan ekspor rentang yang dilewati secara terpisah pada jadwal berikutnya. Pada endpoint retrieve dan messages, lewati ID sesi tersebut, lanjutkan dengan sisa ekspor Anda, dan coba ulang sesi tersebut pada jadwal berikutnya. Cursor halaman messages kedaluwarsa 24 jam setelah halaman pertama walk, jadi mulai ulang walk sesi tersebut tanpa page saat Anda kembali ke sana.

Jika salah satu kondisi ini berulang di berbagai jadwal, hubungi perwakilan Anthropic Anda dan sertakan header respons request-id. Untuk kasus kunci yang dikelola pelanggan, lakukan ini hanya jika error berlanjut saat kunci Anda dapat digunakan.

Untuk insiden di seluruh layanan, periksa status.anthropic.com.

Langkah selanjutnya