• Pesan
  • Managed Agents
  • Admin
Search...
⌘K
Organisasi
Admin APIWorkspace
Autentikasi
IkhtisarWorkload Identity FederationReferensi WIF
Pemantauan
Usage and Cost APIRate Limits APIClaude Code Analytics API
Data & kepatuhan
Residensi dataAPI dan retensi data
Compliance API
IkhtisarDapatkan aksesFeed AktivitasObrolan, file, dan proyekOrganisasi, pengguna, peran, dan grupRancang integrasi AndaKesalahanFAQ
Log in
Feed Aktivitas
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Admin/Compliance API

Mengkueri Activity Feed

Mengambil, memfilter, dan melakukan paginasi pada Activity Feed Compliance API organisasi Anda.

Compliance API diaktifkan berdasarkan permintaan. Organisasi Claude Enterprise memiliki akses ke API lengkap; organisasi Claude Console hanya memiliki akses ke Activity Feed (halaman ini). Lihat Mendapatkan akses ke Compliance API.

Scope yang diperlukan: read:compliance_activities pada Compliance Access Key atau Admin API key.

Baik Compliance Access Key (sk-ant-api01-...) yang membawa scope ini maupun Admin API key (sk-ant-admin01-...) dapat memanggil Activity Feed. Lihat Mendapatkan akses ke 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
curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"
Response
{
  "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"
}

Memfilter aktivitas

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 tipe 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
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 Query compliance activities di referensi API untuk daftar lengkap nilai yang diterima oleh activity_types[].

Melakukan paginasi hasil

Aktivitas dikembalikan dengan yang terbaru terlebih dahulu, dengan nilai created_at yang sama diurutkan berdasarkan ID aktivitas, dan dibatasi hingga limit hasil dalam setiap respons (default 100, maksimum 5.000). Lihat referensi API untuk skema respons lengkap.

Compliance API menggunakan dua skema paginasi tergantung pada kelompok endpoint:

Kelompok endpointUrutan pengurutanSkemaParameter
ActivitiesTerbaru terlebih dahuluCursorafter_id, before_id (dikembalikan sebagai first_id, last_id)
Chats dan chat messagesTerlama terlebih dahuluCursorafter_id, before_id (dikembalikan sebagai first_id, last_id)
Projects, project attachments, users, roles, role permissions, groups, group membersSpesifik per endpointPage tokenpage (dikembalikan sebagai next_page)

Organizations dan files tidak menggunakan paginasi: List organizations mengembalikan semua hasil dalam satu respons, dan file diambil secara individual berdasarkan ID.

Cursor paginasi dan page token adalah string opaque: kirimkan kembali tanpa perubahan. Format internalnya tidak stabil, dan mem-parsing-nya akan menyebabkan kerusakan tanpa pemberitahuan. Hanya satu dari after_id atau before_id yang boleh diatur dalam setiap permintaan, dan kedua skema mengembalikan has_more sehingga Anda tahu kapan harus berhenti.

Untuk melakukan paging melalui aktivitas:

  • Berikan last_id dari respons sebagai after_id untuk maju ke halaman berikutnya dalam urutan hasil. Dengan aktivitas yang diurutkan dari yang terbaru, halaman berikutnya berisi entri yang lebih lama.
  • Berikan first_id sebagai before_id untuk kembali ke halaman sebelumnya.
  • Berhenti ketika has_more bernilai false.

Parameter cursor menentukan arah halaman; urutan pengurutan endpoint menentukan arah waktu. Parameter after_id yang sama menjangkau aktivitas yang lebih lama di sini. Chats diurutkan dari yang terlama; lihat Mengambil dan menghapus chat, file, dan proyek untuk semantik cursor di sana.

Cursor aman untuk digunakan kembali saat retry. Cursor atau page token 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 telah dilewatinya.

cURL
# Ambil halaman pertama (aktivitas terbaru lebih dulu) dan simpan kursor 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 kursor tersebut tanpa perubahan 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 melakukan paging melalui aktivitas yang lebih lama dengan menjalankan iterasi berdasarkan has_more dan last_id:

  1. Mulai dari cursor yang Anda simpan (atau hilangkan after_id untuk memulai dari awal).
  2. Lakukan paging dengan after_id=<last_id> hingga has_more bernilai false.
  3. Simpan 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)

Memahami objek Activity

Setiap entri dalam data adalah sebuah Activity dengan bentuk tingkat atas berikut:

FieldTipeDeskripsi
idstringPengidentifikasi unik untuk aktivitas.
created_atstring RFC 3339Kapan aktivitas terjadi.
organization_idstring atau nullOrganisasi tempat aktivitas terjadi, atau null untuk peristiwa yang tidak terkait dengan organisasi (sign-in, sign-out, panggilan Compliance API).
organization_uuidstring atau nullCakupan yang sama dengan organization_id, dinyatakan sebagai UUID.
actorActor unionSiapa atau apa yang melakukan aktivitas. Lihat tabel aktor berikut.
typestringJenis aktivitas, misalnya claude_chat_created.
field tambahanbervariasiField spesifik per jenis, misalnya claude_chat_id pada peristiwa chat atau filename pada peristiwa file. Lihat Query compliance activities di referensi API untuk daftar field per jenis.

Field actor adalah discriminated union. Diskriminator type memberi tahu Anda field lain mana yang ada:

actor.typeKapan munculField utama
user_actorPengguna claude.ai atau Claude Console yang sudah masuk melakukan tindakan tersebut.email_address, user_id, ip_address, user_agent
api_actorSebuah 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 Admin API key.api_key_id, ip_address, user_agent
admin_api_key_actorAdmin organisasi menggunakan Admin API key untuk mengelola pengguna, undangan, workspace, atau kunci API.admin_api_key_id
unauthenticated_user_actorTindakan terjadi sebelum proses masuk selesai, misalnya sso_login_initiated.unauthenticated_email_address, ip_address, user_agent
anthropic_actorAnthropic bertindak atas organisasi, misalnya melalui tooling internal.email_address (selalu null; ada untuk konsistensi bentuk dengan user_actor, karena operator Anthropic tidak direpresentasikan oleh email individual)
scim_directory_sync_actorPenyedia 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.

Langkah selanjutnya

Referensi API

Skema permintaan dan respons lengkap untuk GET /v1/compliance/activities, termasuk setiap nilai activity_types[] yang didukung.

Mengambil dan menghapus chat, file, dan proyek

Kueri dan hapus konten yang mendasari aktivitas yang Anda temukan di feed (memerlukan Compliance Access Key).

Merancang integrasi compliance Anda

Pilih pola konsumsi polling atau batch dan rencanakan korelasi SIEM.

Menangani kesalahan Compliance API

Katalog kesalahan lengkap.

Was this page helpful?

  • Memfilter aktivitas
  • Melakukan paginasi hasil
  • Memahami objek Activity
  • Langkah selanjutnya