Untuk mengaktifkan Compliance API, lihat Menyiapkan Compliance API.
Scope yang diperlukan: read:compliance_activities pada Compliance Access Key atau kunci Admin API.
Baik Compliance Access Key (sk-ant-api01-...) yang membawa scope ini maupun kunci Admin API (sk-ant-admin01-...) dapat memanggil Activity Feed. Lihat Menyiapkan Compliance API untuk kondisi di mana setiap jenis kunci membawa scope tersebut.
Activity Feed mencatat setiap tindakan autentikasi, chat, file, proyek, administratif, dan platform yang terjadi di organisasi Anda, dalam urutan kronologis terbalik. Aktivitas dapat dikueri dalam waktu 1 menit setelah terjadi dan disimpan selama 6 tahun.
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=1" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"{
"data": [
{
"id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
"created_at": "2026-04-10T08:09:10Z",
"organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
"organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
"actor": {
"type": "user_actor",
"email_address": "[email protected]",
"user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
"ip_address": "192.0.2.34",
"user_agent": "Mozilla/5.0..."
},
"type": "claude_chat_created",
"claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
"claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
}
],
"has_more": true,
"first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
"last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}Filter berdasarkan organisasi, aktor, jenis aktivitas, atau jendela waktu created_at menggunakan sub-parameter bertitik created_at.gte, .gt, .lte, dan .lt. Lihat referensi API untuk jenis dan nilai yang diterima setiap parameter.
Parameter yang dapat diulang menggunakan sintaks kueri array-bracket: berikan activity_types[]=..., actor_ids[]=..., atau organization_ids[]=... satu kali untuk setiap nilai.
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/activities" \
--data-urlencode "activity_types[]=claude_file_uploaded" \
--data-urlencode "activity_types[]=claude_chat_created" \
--data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"Activity Feed menghasilkan ratusan jenis aktivitas yang berbeda. Lihat Melakukan kueri aktivitas kepatuhan di referensi API untuk daftar lengkap nilai yang diterima oleh activity_types[].
Aktivitas dikembalikan dari yang terbaru terlebih dahulu, dengan nilai created_at yang sama diurutkan berdasarkan ID aktivitas, dan dibatasi hingga limit hasil di setiap respons (default 100, maksimum 5.000). Lihat referensi API untuk skema respons lengkap.
Compliance API menggunakan dua skema paginasi tergantung pada keluarga endpoint:
| Keluarga endpoint | Urutan pengurutan | Skema | Parameter |
|---|---|---|---|
| Aktivitas | Terbaru terlebih dahulu | Cursor | after_id, before_id (dikembalikan sebagai first_id, last_id) |
| Chat dan pesan chat | Terlama terlebih dahulu | Cursor | after_id, before_id (dikembalikan sebagai first_id, last_id) |
| Organisasi, proyek, lampiran proyek, pengguna, peran, izin peran, grup, anggota grup | Spesifik per endpoint | Token halaman | page (dikembalikan sebagai next_page) |
File tidak dipaginasi: file diambil satu per satu berdasarkan ID.
Cursor paginasi dan token halaman adalah string opak: kembalikan tanpa diubah. Format internalnya tidak stabil, dan mem-parsing-nya akan rusak tanpa pemberitahuan. Hanya salah satu dari after_id atau before_id yang boleh diatur di setiap permintaan, dan kedua skema mengembalikan has_more sehingga Anda tahu kapan harus berhenti.
Untuk menelusuri halaman aktivitas:
last_id dari respons sebagai after_id untuk maju ke halaman berikutnya dalam urutan hasil. Dengan aktivitas yang diurutkan dari yang terbaru terlebih dahulu, halaman berikutnya berisi entri yang lebih lama.first_id sebagai before_id untuk kembali ke halaman sebelumnya.has_more bernilai false.Parameter cursor menentukan arah halaman; urutan pengurutan endpoint menentukan arah waktu. Parameter after_id yang sama mencapai aktivitas yang lebih lama di sini. Chat diurutkan dari yang terlama terlebih dahulu; lihat Mengambil dan menghapus chat, file, dan proyek untuk semantik cursor di sana.
Cursor aman untuk digunakan kembali saat mencoba ulang. Cursor atau token halaman dari halaman yang berhasil dikembalikan tetap valid; permintaan yang gagal (5xx, timeout, kesalahan jaringan) tidak memajukan posisi Anda. Coba ulang permintaan yang sama dengan cursor yang sama. Hanya pindah ke cursor berikutnya setelah Anda menyimpan halaman yang dilewatinya.
# Ambil halaman pertama (aktivitas terbaru lebih dulu) dan simpan cursor di bagian akhirnya.
last_id=$(curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=2" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" | jq -er '.last_id')
# Kirim kembali cursor tersebut tanpa diubah untuk mengambil halaman berikutnya (yang lebih lama).
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/activities" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--data-urlencode "limit=2" \
--data-urlencode "after_id=${last_id}"Loop backfill produksi menelusuri aktivitas yang lebih lama dengan menggerakkan iterasi berdasarkan has_more dan last_id:
after_id untuk memulai dari awal).after_id=<last_id> hingga has_more bernilai false.last_id terakhir hanya setelah Anda menyimpan setiap halaman yang dicakupnya.cursor = stored_cursor
loop:
if cursor is not null:
page = GET /v1/compliance/activities?after_id={cursor}&limit=100
else:
page = GET /v1/compliance/activities?limit=100
store(page.data)
if page.last_id is not null:
cursor = page.last_id
if not page.has_more: break
persist(cursor)Setiap entri dalam data adalah Activity dengan bentuk tingkat atas berikut:
| Field | Tipe | Deskripsi |
|---|---|---|
id | string | Pengidentifikasi unik untuk aktivitas. |
created_at | string RFC 3339 | Kapan aktivitas terjadi. |
organization_id | string atau null | Organisasi tempat aktivitas terjadi, atau null untuk peristiwa yang tidak terkait dengan organisasi (masuk, keluar, panggilan Compliance API). |
organization_uuid | string atau null | Cakupan yang sama dengan organization_id, dinyatakan sebagai UUID. |
actor | Union Actor | Siapa atau apa yang melakukan aktivitas. Lihat tabel aktor berikut. |
type | string | Jenis aktivitas, misalnya claude_chat_created. |
| field tambahan | bervariasi | Field spesifik per jenis, misalnya claude_chat_id pada peristiwa chat atau filename pada peristiwa file. Lihat Melakukan kueri aktivitas kepatuhan di referensi API untuk daftar field per jenis. |
Field actor adalah discriminated union. Diskriminator type memberi tahu Anda field lain mana yang ada:
actor.type | Kapan muncul | Field kunci |
|---|---|---|
user_actor | Pengguna claude.ai atau Claude Console yang sudah masuk melakukan tindakan. | email_address, user_id, ip_address, user_agent |
api_actor | Sebuah permintaan memanggil Claude API atau Compliance API dengan kunci API yang diterbitkan pelanggan. Panggilan Compliance API menghasilkan jenis aktor ini baik untuk Compliance Access Key maupun kunci Admin API. | api_key_id, ip_address, user_agent |
admin_api_key_actor | Admin organisasi menggunakan kunci Admin API untuk mengelola pengguna, undangan, workspace, atau kunci API. | admin_api_key_id |
unauthenticated_user_actor | Tindakan terjadi sebelum proses masuk selesai, misalnya sso_login_initiated. | unauthenticated_email_address, ip_address, user_agent |
anthropic_actor | Anthropic bertindak pada organisasi, misalnya melalui perangkat internal. | email_address (selalu null; ada untuk konsistensi bentuk dengan user_actor, karena operator Anthropic tidak direpresentasikan oleh email individual) |
scim_directory_sync_actor | Penyedia identitas (seperti Okta, Microsoft Entra ID, atau JumpCloud) mendorong perubahan melalui sinkronisasi direktori SCIM. | workos_event_id, directory_id, idp_connection_type (nullable; misalnya OktaSCIMV2, AzureSCIMV2) |
Bangun handler yang kompatibel ke depan. Teruskan nilai type dan
actor.type yang tidak dikenali, dan abaikan field yang tidak diharapkan oleh handler Anda, sehingga
integrasi Anda tetap berfungsi ketika jenis aktivitas baru dirilis.
Skema permintaan dan respons lengkap untuk GET /v1/compliance/activities, termasuk setiap nilai activity_types[] yang didukung.
Kueri dan hapus konten yang mendasari aktivitas yang Anda temukan di feed (memerlukan Compliance Access Key).
Pilih pola konsumsi polling atau batch dan rencanakan korelasi SIEM.
Katalog kesalahan lengkap.
Was this page helpful?