Daftar organisasi, pengguna, peran, grup, dan pengaturan

Endpoint di halaman ini mengekspos sisi direktori dari organisasi Claude Enterprise: organisasi tertautnya, pengguna di masing-masing organisasi, peran yang didefinisikan pada masing-masing, serta grup "role-based access control" (kontrol akses berbasis peran), atau RBAC, maupun grup yang disediakan melalui SCIM (System for Cross-domain Identity Management) beserta anggotanya. Gunakan endpoint ini untuk mengisi 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 pengaturan efektif 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 tersebut terikat.

Panggilan berikut mendaftar 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, teruskan kembali token next_page yang dikembalikan tanpa perubahan sebagai parameter query page pada permintaan 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 lain di seluruh Compliance API:

Sebagian besar API Anthropic lainnya menggunakan bentuk berawalan org_.

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

Daftar pengguna organisasi

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

Endpoint ini memerlukan read:compliance_user_data, bukan read:compliance_org_data. Buat Compliance Access Key dengan kedua cakupan 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 query limit dan page.

Hasil diurutkan berdasarkan tanggal bergabung ke organisasi secara menaik. Berbeda dengan kursor before_id/after_id pada Activity Feed (lihat Paginasi hasil), endpoint direktori melakukan paginasi dengan token next_page: ketika has_more bernilai true, teruskan kembali next_page tanpa perubahan sebagai parameter query 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": "priya@example.com",
      "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 dengan yang diterima oleh filter actor_ids[] pada Query Activity Feed dan filter user_ids[] pada Mengambil chat dan pesan serta daftar sesi remote; daftar sesi lokal tidak memiliki filter pengguna, jadi atribusikan sesi lokal berdasarkan user.id pada setiap objek sesi. Field organization_role membawa tingkat keanggotaan bawaan pengguna dalam organisasi yang didaftar (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 mendaftar pengguna untuk satu atau lebih organisasi, memfilternya terhadap catatan eksternal Anda sendiri, dan memasukkan ID yang dihasilkan ke dalam query 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 di-query melalui Activity Feed selama jendela retensi penuh, diindeks dengan ID user_... yang sama.

Daftar peran

Endpoint List Compliance Roles mengembalikan daftar catatan peran berpaginasi 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 mendaftar izin yang saat ini diberikan kepada suatu peran, gunakan List Compliance Role Permissions. Untuk mengaudit penugasan peran historis dan perubahan izin, query tipe 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 berpaginasi grup RBAC dan grup yang disediakan melalui SCIM, 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 cakupan untuk menelusuri grup dari ujung ke ujung. 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 mendaftar ID peran yang ditugaskan ke grup, sesuai 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).

Daftar grup, lalu untuk setiap grup daftar 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, daftar 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": "priya@example.com",
      "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 dengan yang diterima Activity Feed, daftar chat, dan daftar sesi remote; field ini juga cocok dengan user.id pada objek sesi lokal dan pada objek sesi remote milik pengguna (sesi remote milik agen membawa ID manusianya di started_by_user.id sebagai gantinya). 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: status yang ditegakkan setelah pembatasan regulasi (seperti HIPAA), aturan ketersediaan fitur, default tipe organisasi, dan dependensi antarfitur diterapkan, yang dapat berbeda dari apa yang dikonfigurasi administrator. Gunakan endpoint ini untuk membuktikan bahwa jendela retensi, redaksi konten, penegakan single sign-on, allowlist IP, dan kontrol durasi sesi sesuai dengan baseline terdokumentasi Anda, tanpa akses Console administrator.

Endpoint ini memerlukan read:compliance_org_data; kunci tanpa cakupan 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 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 Compliance API lainnya; 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 tidak ada sebagai "tidak dapat dikendalikan oleh administrator organisasi ini", bukan sebagai "nonaktif". Contoh ringkas berikut menunjukkan tiga dari baris yang dapat dimuat 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, terdapat di Get effective organization settings di referensi API.

Array api_keys mendaftar setiap Compliance Access Key yang dikonfigurasi untuk organisasi induk Anda, sehingga daftar yang sama dikembalikan terlepas dari organisasi tertaut mana yang Anda query. 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 cakupan read:compliance_org_settings yang telah dipensiunkan tetap ada dalam daftar untuk visibilitas audit dan pembersihan meskipun cakupan tersebut tidak lagi memberikan akses.

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

Baris mencerminkan status yang ditegakkan, 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 allowlist aktif dan memiliki setidaknya satu rentang aktif, dan code_execution_network_egress_enabled bernilai false setiap kali eksekusi kode nonaktif.

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

Langkah selanjutnya