Daftar organisasi, pengguna, peran, grup, dan pengaturan

Endpoint pada halaman ini mengekspos sisi direktori dari organisasi Claude Enterprise: organisasi yang tertaut, pengguna di masing-masing organisasi, peran yang didefinisikan pada masing-masing organisasi, dan grup "role-based access control" (kontrol akses berbasis peran), atau RBAC, atau grup yang disediakan melalui "SCIM (System for Cross-domain Identity Management)" beserta anggotanya. Gunakan endpoint ini untuk menyemai daftar pengguna eDiscovery, membangun dasbor pelaporan, dan merekonsiliasi keanggotaan grup terhadap sistem pencatatan eksternal. Compliance Access Key yang mencakup organisasi induk mengembalikan data dari setiap organisasi tertaut di bawahnya, sehingga satu kunci menjangkau seluruh pohon. Endpoint effective-settings melengkapi direktori: endpoint ini mengembalikan pengaturan privasi data, keamanan, dan kapabilitas yang benar-benar berlaku untuk satu organisasi.



Daftar organisasi

Endpoint List organizations mengembalikan setiap organisasi di bawah induk tempat kunci terikat.

Panggilan berikut mencantumkan setiap organisasi di bawah induk Anda. Responsnya adalah array data berisi catatan organisasi yang diurutkan berdasarkan created_at secara menaik, ditambah has_more dan next_page untuk paginasi. Ketika has_more bernilai true, kirimkan kembali token next_page yang dikembalikan tanpa perubahan sebagai parameter kueri page pada permintaan Anda berikutnya. Lihat List organizations di referensi API untuk nilai default dan rentang parameter limit dan page.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "name": "Acme Engineering",
      "created_at": "2025-06-01T10:00:00Z"
    },
    {
      "uuid": "5a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Acme Legal",
      "created_at": "2025-07-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Field uuid adalah pengidentifikasi kanonis untuk pencarian lanjutan. Tabel berikut memetakannya ke pengidentifikasi organisasi lainnya di seluruh Compliance API:

Sebagian besar API Anthropic lainnya menggunakan bentuk dengan awalan org_.

Untuk melacak perubahan keanggotaan organisasi dari waktu ke waktu, daftarkan ulang endpoint ini secara berkala, dengan mengikuti token next_page melalui setiap halaman pada setiap putaran. Activity Feed juga menampilkan peristiwa keanggotaan melalui jenis aktivitas org_deletion_requested, org_deleted_via_bulk, org_parent_join_proposal_created, dan org_join_proposal_decided; lihat Mengkueri Activity Feed.



Daftar pengguna organisasi

Endpoint List organization users mengembalikan daftar catatan pengguna yang dipaginasi untuk satu organisasi.

Endpoint ini memerlukan read:compliance_user_data, bukan read:compliance_org_data. Buat Compliance Access Key dengan kedua scope tersebut jika Anda bermaksud menggunakannya untuk enumerasi direktori; jika tidak, panggilan akan mengembalikan 403 Forbidden.

Lihat List organization users di referensi API untuk nilai default dan rentang parameter kueri limit dan page.

Hasil diurutkan berdasarkan tanggal bergabung ke organisasi secara menaik. Berbeda dengan kursor before_id/after_id pada Activity Feed (lihat Memaginasi hasil), endpoint direktori melakukan paginasi dengan token next_page: ketika has_more bernilai true, kirimkan kembali next_page tanpa perubahan sebagai parameter kueri page pada permintaan berikutnya.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/users" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=500"

{
  "data": [
    {
      "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "full_name": "Priya Sharma",
      "email": "[email protected]",
      "organization_role": "admin",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_8aW5kZXgicG9zaXRpb25fdG9rZW5fOTE0"
}

ID pengguna yang dikembalikan di sini adalah pengidentifikasi user_... yang sama yang diterima oleh filter actor_ids[] pada Mengkueri Activity Feed dan filter user_ids[] pada Mengambil chat dan pesan. Field organization_role membawa tingkat keanggotaan bawaan pengguna dalam organisasi yang terdaftar (salah satu dari admin, billing, claude_code_user, developer, managed, membership_admin, owner, primary_owner, atau user), sebuah sumbu yang independen dari penugasan peran RBAC kustom apa pun yang dikembalikan oleh Daftar peran. Alur eDiscovery yang umum mencantumkan pengguna untuk satu atau beberapa organisasi, memfilternya terhadap catatan eksternal Anda sendiri, dan memasukkan ID yang dihasilkan ke dalam kueri chat dan proyek.

Seorang pengguna hanya muncul di sini selama mereka menjadi anggota aktif organisasi. Pengguna yang dihapus langsung dikeluarkan dari daftar. Aktivitas historis mereka tetap dapat dikueri melalui Activity Feed selama seluruh jendela retensi, diindeks dengan ID user_... yang sama.



Daftar peran

Endpoint List Compliance Roles mengembalikan daftar catatan peran yang dipaginasi yang didefinisikan pada satu organisasi, dan Get Compliance Role mengembalikan satu peran berdasarkan ID.

Kedua endpoint peran memerlukan read:compliance_org_data. Endpoint daftar menerima parameter limit dan page yang sama dengan endpoint pengguna organisasi.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/${org_uuid}/roles" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh",
      "name": "Compliance Reviewer",
      "description": "Read-only access to chat and project content for legal review.",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Lihat skema respons List Compliance Roles untuk bentuk lengkap catatan peran. Untuk mencantumkan izin yang saat ini diberikan kepada suatu peran, gunakan List Compliance Role Permissions. Untuk mengaudit penugasan peran historis dan perubahan izin, kueri jenis aktivitas RBAC (misalnya, rbac_role_assigned dan rbac_role_permission_added) melalui Activity Feed; lihat Memfilter aktivitas.



Daftar grup dan anggota

Endpoint List Compliance Groups mengembalikan daftar grup RBAC dan grup yang disediakan melalui SCIM yang dipaginasi, dan Get Compliance Group mengembalikan satu grup berdasarkan ID. Endpoint List Compliance Group Members mengembalikan anggota dari satu grup.

Endpoint daftar dan pengambilan grup memerlukan read:compliance_org_data. Endpoint anggota memerlukan read:compliance_user_data. Buat kunci dengan kedua scope tersebut untuk menelusuri grup dari awal hingga akhir. Kedua endpoint daftar menerima parameter limit dan page yang sama dengan endpoint pengguna organisasi.

Lihat skema respons List Compliance Groups untuk bentuk lengkap catatan grup. Array roles mencantumkan ID peran yang ditetapkan ke grup, yang cocok dengan ID dari Daftar peran. source_type adalah pembeda antara grup yang dibuat secara manual melalui claude.ai (direct) dan grup yang disinkronkan dari penyedia identitas eksternal melalui SCIM (scim).

Daftarkan grup, lalu untuk setiap grup daftarkan anggotanya:

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK",
      "name": "Engineering",
      "description": "Engineering team members",
      "source_type": "scim",
      "roles": ["rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh"],
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Untuk setiap ID grup, daftarkan anggotanya:

group_id="rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups/$group_id/members" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "user_id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "email": "[email protected]",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Lihat skema respons List Compliance Group Members untuk bentuk lengkap catatan anggota. Field user_id adalah pengidentifikasi user_... yang sama yang diterima oleh Activity Feed dan daftar chat. Untuk mendapatkan nama lengkap anggota, cari melalui daftar pengguna organisasi.



Mendapatkan pengaturan organisasi efektif

Endpoint Get effective organization settings mengembalikan pengaturan yang berlaku untuk satu organisasi di bawah induk Anda: keadaan yang diberlakukan setelah pembatasan regulasi (seperti HIPAA), aturan ketersediaan fitur, default jenis organisasi, dan ketergantungan antar-fitur diterapkan, yang dapat berbeda dari apa yang dikonfigurasi oleh administrator. Gunakan endpoint ini untuk membuktikan bahwa jendela retensi, penyuntingan konten, penegakan single sign-on, daftar IP yang diizinkan, dan kontrol durasi sesi sesuai dengan baseline terdokumentasi Anda, tanpa akses Console administrator.

Endpoint ini memerlukan read:compliance_org_data; kunci tanpa scope tersebut mengembalikan 403 Forbidden. Target harus merupakan salah satu organisasi tertaut milik induk: organisasi induk itu sendiri bukan target yang valid. Organisasi yang tidak dikenal, ID organisasi yang bukan UUID yang valid, organisasi di luar pohon induk Anda, dan organisasi induk yang belum memiliki akses ke endpoint ini semuanya mengembalikan 404 Not Found yang sama, sehingga 404 tidak mengungkapkan apakah suatu organisasi ada. Endpoint pengaturan diaktifkan per organisasi induk secara terpisah dari bagian lain Compliance API; jika setiap permintaan mengembalikan 404, hubungi perwakilan Anthropic Anda.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/settings" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

Responsnya adalah daftar baris pengaturan bertipe, dan baris mana yang muncul bervariasi menurut organisasi: pengaturan yang tidak dapat diubah oleh administrator organisasi, karena dikendalikan oleh kebijakan Anthropic atau tidak tersedia untuk organisasi tersebut, dihilangkan dari daftar. Perlakukan baris yang hilang sebagai "tidak dapat dikendalikan oleh administrator organisasi ini", bukan sebagai "nonaktif". Contoh ringkas berikut menunjukkan tiga dari baris yang dapat dikandung oleh sebuah respons:

{
  "type": "effective_organization_settings",
  "organization_id": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "settings": [
    {
      "name": "data_retention_periods",
      "type": "data_retention",
      "value": {
        "chat": {
          "type": "fixed",
          "timescale": "day",
          "duration": 90
        }
      }
    },
    {
      "name": "content_redaction_enabled",
      "type": "boolean",
      "value": true
    },
    {
      "name": "ip_allowlist_ip_ranges",
      "type": "string_list",
      "value": ["10.0.0.0/8", "203.0.113.0/24"]
    }
  ],
  "api_keys": [
    {
      "type": "compliance_api_key",
      "id": "apikey_01Hx7k2mP9nQ4rS6tU8vW0xY",
      "name": "Compliance Export Key",
      "scopes": ["read:compliance_activities", "read:compliance_org_data"],
      "is_active": true,
      "created_at": "2026-03-14T09:30:00Z",
      "created_by_id": "user_01Jz3a4bC5dE6fG7hI8jK9lM",
      "expires_at": null
    }
  ]
}

Setiap baris membawa name, type, dan value; field type (boolean, integer, string_list, provisioning_mode, atau data_retention) memberi tahu Anda bentuk dari value. Daftar lengkap nama pengaturan, dan skema value untuk setiap tipe, ada di Get effective organization settings di referensi API.

Array api_keys mencantumkan setiap Compliance Access Key yang dikonfigurasi untuk organisasi induk Anda, sehingga daftar yang sama dikembalikan terlepas dari organisasi tertaut mana yang Anda kueri. Setiap entri membawa type kunci (compliance_api_key), id, name, scopes, flag is_active, stempel waktu created_at dan expires_at, serta created_by_id (ID pengguna yang membuat kunci; dapat bernilai null). Nilai rahasia kunci tidak pernah dikembalikan. Kunci yang dinonaktifkan disertakan dengan is_active: false sehingga Anda dapat meninjau kunci yang sebelumnya memiliki akses, dan kunci yang hanya membawa scope read:compliance_org_settings yang telah dihentikan tetap ada dalam daftar untuk visibilitas audit dan pembersihan meskipun scope tersebut tidak lagi memberikan akses.

organization_id tingkat atas adalah UUID polos organisasi: nilai yang sama dengan uuid dalam daftar organisasi, bukan bentuk dengan awalan org_ yang dibawa organization_id pada catatan Activity Feed, chat, dan proyek (lihat tabel pengidentifikasi organisasi).

Baris mencerminkan keadaan yang diberlakukan, bukan konfigurasi yang terakhir disimpan: misalnya, sso_provisioning_mode melaporkan mode SCIM yang dikonfigurasi hanya selama sinkronisasi direktori diaktifkan, ip_allowlist_enabled bernilai true hanya selama daftar yang diizinkan aktif dan memiliki setidaknya satu rentang aktif, dan code_execution_network_egress_enabled bernilai false setiap kali eksekusi kode nonaktif.

Respons mencerminkan keadaan pada saat pembacaan; tidak ada yang di-snapshot. Perubahan pada sebagian besar pengaturan ini muncul sebagai peristiwa di Activity Feed; gunakan endpoint ini untuk keadaan terselesaikan saat ini dan gunakan feed untuk mengaudit siapa yang mengubah apa, dan kapan.



Langkah selanjutnya