Manajemen pengguna

Halaman ini membahas pengelolaan orang-orang di organisasi Claude Enterprise (claude.ai) Anda secara terprogram, menggunakan Admin API: mendaftarkan anggota dan mencarinya berdasarkan alamat email, mengubah peran anggota, menghapus anggota, mengirim dan menarik undangan, mengelola grup enterprise Anda beserta keanggotaannya, dan membaca peran kustom organisasi Anda. Untuk organisasi Claude Console (Claude Platform), lihat panduan Admin API untuk Claude Console.

Endpoint mana yang dapat digunakan organisasi Anda?

Admin API adalah satu set endpoint di bawah https://api.anthropic.com/v1/organizations/. Organisasi Claude Console dan Claude Enterprise melakukan autentikasi dengan kunci yang berbeda dan masing-masing memiliki akses ke subset endpoint yang berbeda:

Anggota dan undangan adalah endpoint yang sama untuk kedua jenis organisasi; halaman ini mendokumentasikan perilakunya pada Claude Enterprise, termasuk peran organisasi Claude Enterprise. Endpoint grup dan peran kustom hanya ada untuk Claude Enterprise.

Ikhtisar

Halaman ini membahas lima sumber daya:

Peran kustom dan pelampirannya ke grup dikelola di pengaturan organisasi claude.ai; API membacanya tetapi tidak dapat mengubahnya.

Mulai cepat

Daftarkan anggota organisasi, yang terbaru terlebih dahulu:

curl "https://api.anthropic.com/v1/organizations/users?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

{
  "data": [
    {
      "type": "user",
      "id": "user_01AbCdEfGhIjKlMnOpQrSt",
      "email": "jane@example.com",
      "name": "Jane Smith",
      "role": "user",
      "added_at": "2026-06-12T09:14:03Z"
    }
  ],
  "has_more": false,
  "first_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "last_id": "user_01AbCdEfGhIjKlMnOpQrSt"
}

Konsep utama

Peran organisasi

Setiap anggota memiliki tepat satu peran organisasi. Pembacaan mengembalikan peran anggota sebagai salah satu dari lima nilai:

API hanya dapat menetapkan peran user dan managed, pada pembuatan undangan dan pada pembaruan peran. Peran administratif (owner, membership_admin, dan primary_owner) ditetapkan di pengaturan organisasi claude.ai, dan anggota yang memegangnya tidak dapat diubah atau dihapus melalui API ini.

Anggota dan undangan

Seseorang menjadi anggota dengan menerima undangan (atau melalui single sign-on organisasi Anda, jika dikonfigurasi). Membuat undangan akan mengirim email undangan; undangan tersebut kemudian terbaca sebagai pending hingga penerima menerimanya (accepted) atau expires_at yang ditetapkan server terlewati (expired). Hanya undangan pending yang dapat ditarik. Untuk mengubah alamat email atau peran pada undangan yang masih pending, tarik undangan tersebut dan buat yang baru.

Jika paket organisasi Anda mengambil anggota dari kumpulan seat yang dibeli dalam jumlah terbatas, undangan pending menggunakan satu seat. Endpoint pembuatan undangan tidak menerima parameter seat atau tier: seat ditetapkan secara otomatis dari tier terendah yang masih tersedia. Membuat undangan ketika tidak ada seat yang kosong akan gagal dengan error 400, bukan membeli seat. Menarik undangan, membiarkannya kedaluwarsa, atau menghapus anggota di kemudian hari akan mengembalikan seat ke kumpulan.

Grup dan peran

Grup menghubungkan anggota dengan peran kustom ("role-based access control" (kontrol akses berbasis peran), atau rbac dalam path endpoint dan nama cakupan). Grup dimiliki oleh enterprise Anda secara keseluruhan (organisasi induk bersama setiap organisasi di bawahnya), bukan oleh satu organisasi, sehingga cakupan grup (read:rbac_groups dan write:rbac_groups) memerlukan kunci yang dibuat untuk semua organisasi tertaut. Setiap grup membawa source_type: direct untuk grup yang dibuat di claude.ai, scim untuk grup yang diprovisikan oleh penyedia identitas Anda. Field roles pada grup mencantumkan ID peran kustom yang terlampir padanya; uraikan menjadi nama dan izin dengan endpoint peran kustom, dengan catatan bahwa katalog peran bersifat per-organisasi sementara grup berlaku di seluruh enterprise, sehingga mengambil peran yang dimiliki organisasi lain dalam enterprise Anda akan mengembalikan 404 untuk kunci Anda. Field ini bernilai null (bukan []) ketika data peran sementara tidak tersedia, jadi coba lagi untuk membedakan pembacaan yang terdegradasi dari grup yang tidak memiliki peran.

Batas laju

Endpoint Admin API berbagi "rate limit" (batas laju) per-organisasi sebesar 100 permintaan per menit; pembuatan undangan memiliki batasnya sendiri sebesar 1.200 permintaan per jam. Permintaan yang melebihi batas mengembalikan 429 Too Many Requests.

Paginasi

Daftar anggota dan undangan menggunakan paginasi berbasis ID: sertakan limit (default 20, maks 1000) ditambah paling banyak satu dari before_id atau after_id, dan lakukan paginasi menggunakan field first_id dan last_id dari setiap respons hingga has_more bernilai false. Daftar grup dan peran kustom menggunakan kursor opak sebagai gantinya: nilai next_page dari respons diteruskan tanpa diubah sebagai parameter page pada permintaan berikutnya, hingga next_page bernilai null.

Respons error

Respons error mengikuti bentuk standar yang didokumentasikan di Error.

Anggota

Mendaftarkan anggota

GET /v1/organizations/users mengembalikan anggota organisasi, yang paling baru ditambahkan terlebih dahulu. Filter berdasarkan email untuk mencari anggota tertentu; pencocokannya tidak peka huruf besar-kecil dan mentoleransi varian umum dari alamat yang sama (misalnya, jane+hiring@example.com cocok dengan jane@example.com). Memerlukan cakupan read:members.

Untuk detail parameter lengkap dan skema respons, lihat List users di referensi API.

curl "https://api.anthropic.com/v1/organizations/users?email=jane@example.com" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Mendapatkan anggota

GET /v1/organizations/users/{user_id} mengembalikan satu anggota berdasarkan ID. Memerlukan cakupan read:members.

Untuk detail parameter lengkap dan skema respons, lihat Get user di referensi API.

curl "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Mengubah peran anggota

POST /v1/organizations/users/{user_id} menetapkan peran anggota menjadi user atau managed. Anggota yang memegang peran administratif (owner, membership_admin, atau primary_owner) tidak dapat diubah melalui endpoint ini, dan peran administratif tidak dapat ditetapkan; keduanya mengembalikan 400 dan dikelola di pengaturan organisasi claude.ai. Jika penyedia identitas organisasi Anda mengelola peran (SSO lanjutan atau provisi SCIM lanjutan), pembaruan peran mengembalikan 400. Memerlukan cakupan write:members.

Untuk detail parameter lengkap dan skema respons, lihat Update user di referensi API.

curl -X POST "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"role": "managed"}'

Menghapus anggota

DELETE /v1/organizations/users/{user_id} menghapus anggota dari organisasi, mengembalikan seat yang dibeli yang mereka tempati ke kumpulan organisasi. Anggota yang memegang peran administratif tidak dapat dihapus melalui endpoint ini, dan jika penyedia identitas Anda mengelola keanggotaan (SCIM), penghapusan mengembalikan 400. Memerlukan cakupan write:members.

Untuk detail parameter lengkap dan skema respons, lihat Remove user di referensi API.

curl -X DELETE "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

{
  "type": "user_deleted",
  "id": "user_01AbCdEfGhIjKlMnOpQrSt"
}

Undangan

Membuat undangan

POST /v1/organizations/invites mengirim email undangan dan mengembalikan undangan dengan expires_at yang ditetapkan server. role harus user atau managed. Jika undangan pending sudah ada untuk alamat email tersebut, atau alamat tersebut sudah dimiliki oleh seorang anggota, permintaan mengembalikan 400 yang menyebutkan sumber daya yang sudah ada. Organisasi yang penyedia identitasnya memprovisikan pengguna secara otomatis (JIT atau SCIM) tidak dapat membuat undangan melalui API. Memerlukan cakupan write:members.

Pada paket yang mengambil anggota dari kumpulan seat terbatas, undangan secara otomatis mengambil seat dari tier terendah yang masih tersedia; API tidak menerima parameter tier. Jika tidak ada seat yang kosong, permintaan gagal dengan error 400, bukan membeli seat. Tambahkan seat melalui manajemen paket organisasi dan coba lagi.

Field opsional rbac_group_ids mencantumkan grup (berdasarkan ID berawalan rbac_group_) yang akan ditetapkan kepada anggota ketika mereka menerima undangan. Menyertakan rbac_group_ids yang tidak kosong juga mengharuskan kunci membawa cakupan write:rbac_groups, karena penetapan grup dapat memberikan izin yang terlampir pada peran grup tersebut.

Untuk detail parameter lengkap dan skema respons, lihat Create invite di referensi API.

curl -X POST "https://api.anthropic.com/v1/organizations/invites" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "email": "newhire@example.com",
    "role": "managed",
    "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
  }'

{
  "type": "invite",
  "id": "invite_01QrStUvWxYzAbCdEfGhIj",
  "email": "newhire@example.com",
  "role": "managed",
  "invited_at": "2026-07-06T16:20:11Z",
  "expires_at": "2026-07-27T16:20:11Z",
  "accepted_at": null,
  "status": "pending",
  "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
}

Mendaftarkan undangan

GET /v1/organizations/invites mengembalikan undangan organisasi, yang terbaru terlebih dahulu, mencakup status pending, accepted, dan expired; tidak ada filter status. Memerlukan cakupan read:members.

Untuk detail parameter lengkap dan skema respons, lihat List invites di referensi API.

curl "https://api.anthropic.com/v1/organizations/invites?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Mendapatkan undangan

GET /v1/organizations/invites/{invite_id} mengembalikan satu undangan berdasarkan ID. Memerlukan cakupan read:members.

Untuk detail parameter lengkap dan skema respons, lihat Get invite di referensi API.

curl "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Menarik undangan

DELETE /v1/organizations/invites/{invite_id} menarik undangan pending, menonaktifkan tautan dalam email undangan. Menarik undangan accepted mengembalikan 400 (hapus anggotanya sebagai gantinya); menarik undangan expired mengembalikan 400. Memerlukan cakupan write:members.

Untuk detail parameter lengkap dan skema respons, lihat Delete invite di referensi API.

curl -X DELETE "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Grup

Grup yang dibuat langsung oleh enterprise Anda, di pengaturan organisasi claude.ai atau melalui API ini (source_type: "direct"), mendukung setiap endpoint di bagian ini. Grup yang diprovisikan oleh penyedia identitas Anda (source_type: "scim") dapat dibaca tetapi tidak dapat diubah: mengganti nama atau menghapus grup SCIM, atau mengubah keanggotaannya, mengembalikan 400, karena penyedia identitas Anda yang memilikinya. Tidak seperti permintaan anggota dan undangan, permintaan grup tidak memerlukan header anthropic-version.

Mendaftarkan grup

GET /v1/organizations/rbac_groups mengembalikan grup enterprise Anda, termasuk grup yang dikelola penyedia identitas (scim). Memerlukan cakupan read:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat List groups di referensi API.

curl "https://api.anthropic.com/v1/organizations/rbac_groups?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rbac_group",
      "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
      "name": "Engineering",
      "source_type": "direct",
      "roles": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],
      "created_at": "2026-03-18T10:01:42Z",
      "updated_at": "2026-05-02T08:55:09Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Mendapatkan grup

GET /v1/organizations/rbac_groups/{group_id} mengembalikan satu grup berdasarkan ID. Memerlukan cakupan read:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat Get group di referensi API.

curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Membuat grup

POST /v1/organizations/rbac_groups membuat grup dengan name yang diberikan (1–255 karakter) tanpa peran atau anggota. Memerlukan cakupan write:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat Create group di referensi API.

curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -d '{"name": "Engineering"}'

{
  "type": "rbac_group",
  "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "name": "Engineering",
  "source_type": "direct",
  "roles": [],
  "created_at": "2026-07-09T18:00:00Z",
  "updated_at": "2026-07-09T18:00:00Z"
}

Mengganti nama grup

POST /v1/organizations/rbac_groups/{group_id} memperbarui grup. name adalah satu-satunya field yang dapat diubah oleh endpoint ini. Memerlukan cakupan write:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat Update group di referensi API.

curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -d '{"name": "Platform Engineering"}'

Menghapus grup

DELETE /v1/organizations/rbac_groups/{group_id} menghapus grup. Anggotanya tetap menjadi anggota organisasi mereka, tetapi mereka kehilangan izin dari peran yang terlampir pada grup tersebut, dan batas pengeluaran grup, jika ada, berhenti berlaku bagi mereka. Memerlukan cakupan write:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat Delete group di referensi API.

curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "type": "rbac_group_deleted"
}

Mendaftarkan anggota grup

GET /v1/organizations/rbac_groups/{group_id}/members mengembalikan anggota grup (masing-masing dengan user_id dan email mereka), yang terlama terlebih dahulu. Hanya anggota aktif dari organisasi enterprise Anda yang dikembalikan, sehingga satu halaman mungkin berisi kurang dari limit entri sementara has_more bernilai true. Memerlukan cakupan read:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat List group members di referensi API.

curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members?limit=100" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rbac_group_member",
      "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
      "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
      "email": "jane@example.com",
      "created_at": "2026-04-07T12:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Menambahkan anggota ke grup

POST /v1/organizations/rbac_groups/{group_id}/members menambahkan anggota organisasi ke grup berdasarkan user_id. Pengguna tersebut harus sudah menjadi anggota salah satu organisasi enterprise Anda (jika tidak, permintaan mengembalikan 404), dan menambahkan seseorang yang sudah ada di grup mengembalikan 400. Untuk grup scim, keanggotaan dikelola di penyedia identitas Anda dan permintaan ini mengembalikan 400. Untuk menetapkan grup kepada seseorang yang belum bergabung, gunakan rbac_group_ids pada pembuatan undangan sebagai gantinya. Memerlukan cakupan write:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat Add group member di referensi API.

curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -d '{"user_id": "user_01AbCdEfGhIjKlMnOpQrSt"}'

{
  "type": "rbac_group_member",
  "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "email": "jane@example.com",
  "created_at": "2026-07-09T18:00:00Z"
}

Menghapus anggota dari grup

DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id} menghapus anggota dari grup; mereka tetap menjadi anggota organisasi mereka. Permintaan mengembalikan 404 jika pengguna bukan anggota grup, dan 400 untuk grup scim, yang keanggotaannya dikelola di penyedia identitas Anda. Memerlukan cakupan write:rbac_groups.

Untuk detail parameter lengkap dan skema respons, lihat Remove group member di referensi API.

curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "type": "rbac_group_member_deleted"
}

Peran kustom

Peran kustom bersifat hanya-baca melalui API: endpoint ini mengatalogkan peran kustom organisasi Anda (yang didefinisikan di pengaturan organisasi claude.ai atau diprovisikan oleh Anthropic) dan izin yang diberikan oleh setiap peran. Pembacaan peran kustom menggunakan cakupan read:members (tidak ada cakupan peran terpisah) dan berfungsi dengan kunci tingkat organisasi: tidak seperti endpoint grup, endpoint ini tidak memerlukan kunci yang dibuat untuk semua organisasi tertaut, dan katalog yang dikembalikan adalah milik organisasi Anda sendiri.

Mendaftarkan peran

GET /v1/organizations/rbac_roles mengembalikan peran kustom organisasi Anda. Memerlukan cakupan read:members.

Untuk detail parameter lengkap dan skema respons, lihat List roles di referensi API.

curl "https://api.anthropic.com/v1/organizations/rbac_roles?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rbac_role",
      "id": "rbac_role_01CdEfGhIjKlMnOpQrStUv",
      "name": "Engineering base",
      "created_at": "2026-03-18T10:01:42Z",
      "updated_at": "2026-05-02T08:55:09Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Mendapatkan peran

GET /v1/organizations/rbac_roles/{role_id} mengembalikan satu peran berdasarkan ID. Memerlukan cakupan read:members.

Untuk detail parameter lengkap dan skema respons, lihat Get role di referensi API.

curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Mendaftarkan izin peran

GET /v1/organizations/rbac_roles/{role_id}/permissions mengembalikan izin peran tersebut. Setiap izin memasangkan resource (apa yang menjadi sasarannya: fitur produk organisasi, alat konektor, cakupan OAuth konektor, satu konektor, atau setiap konektor) dengan action (apa yang diberikannya pada sumber daya tersebut). Baris untuk fitur yang tidak diaktifkan bagi organisasi Anda dihilangkan, sehingga satu halaman mungkin berisi kurang dari limit baris sementara has_more bernilai true. Memerlukan cakupan read:members.

Dua nilai action memerlukan perhatian khusus: izin organization yang action-nya adalah capability_access_all (setiap fitur produk) atau capability_access_all_ga (setiap fitur produk stabil, yaitu setiap fitur yang tidak berlabel beta atau research preview) merupakan pemberian menyeluruh (yang tidak mencakup akses model maupun izin panel admin berawalan permission_) dan dicantumkan sebagai satu baris tersebut, bukan diperluas. Ketika Anda menghitung apa yang diberikan oleh suatu peran, perlakukan baris menyeluruh sebagai mencakup semua yang dijelaskan oleh variannya, bukan hanya fitur yang disebutkan di baris lain.

Untuk detail parameter lengkap dan skema respons, lihat List role permissions di referensi API.

curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv/permissions?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rbac_role_permission",
      "resource": {
        "type": "organization",
        "organization_id": "12345678-1234-5678-1234-567812345678"
      },
      "action": "capability_access_all_ga"
    },
    {
      "type": "rbac_role_permission",
      "resource": {
        "type": "connector_tool",
        "connector_id": "mcpsrv_01WxYzAbCdEfGhIjKlMnOp",
        "tool_name": "search_tickets"
      },
      "action": "use"
    }
  ],
  "has_more": false,
  "next_page": null
}

Contoh alur kerja

Offboarding karyawan yang keluar

1. Cari anggota berdasarkan email:

   cURL

   

   curl "https://api.anthropic.com/v1/organizations/users?email=departing@example.com" \
     -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
     -H "anthropic-version: 2023-06-01"

2. Hapus mereka dengan DELETE /v1/organizations/users/{user_id}, menggunakan id dari respons. Seat mereka, jika ada, kembali ke kumpulan.

3. Jika orang tersebut belum bergabung, pencarian tidak mengembalikan anggota; daftarkan undangan dan tarik undangan pending mereka sebagai gantinya.

Mengaudit keanggotaan grup

1. Daftarkan grup dan catat id, name, dan roles setiap grup.

2. Untuk setiap grup yang membawa peran sensitif, lakukan paginasi melalui GET /v1/organizations/rbac_groups/{group_id}/members dan bandingkan email anggota dengan daftar di penyedia identitas Anda.

3. Hapus anggota yang seharusnya tidak lagi berada di grup dengan DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id}. Untuk grup scim, lakukan perubahan di penyedia identitas Anda sebagai gantinya.

Untuk alur kerja yang menggabungkan keanggotaan grup dengan kenaikan batas pengeluaran sementara, lihat Menaikkan batas pengeluaran anggota untuk sementara selama insiden di halaman Spend Limits API.

Pertanyaan yang sering diajukan

Apakah ini API yang berbeda dari Admin API?

Tidak. Endpoint anggota dan undangan adalah endpoint /v1/organizations/ yang sama dengan yang digunakan organisasi Claude Console; halaman ini mendokumentasikan perilakunya pada Claude Enterprise. Endpoint grup dan peran kustom merupakan bagian dari API yang sama dan hanya ada untuk organisasi Claude Enterprise. Tabel ketersediaan menunjukkan endpoint mana yang dapat dipanggil oleh setiap jenis organisasi.

Dapatkah saya menetapkan peran owner atau membership admin melalui API?

Tidak. API hanya menetapkan user dan managed, pada pembuatan undangan dan pembaruan peran. Peran administratif ditetapkan di pengaturan organisasi claude.ai, dan anggota yang memegangnya tidak dapat diubah atau dihapus melalui API.

Dapatkah saya membuat atau mengubah grup melalui API?

Ya, dengan cakupan write:rbac_groups: membuat, mengganti nama, dan menghapus grup, serta menambah atau menghapus anggotanya. Dua hal yang tidak dapat diubah oleh API: grup yang diprovisikan oleh penyedia identitas Anda (source_type: "scim"), yang nama dan keanggotaannya dimiliki oleh penyedia identitas, dan peran kustom, yang dikelola di pengaturan organisasi claude.ai (API membacanya).

Apakah undangan yang belum diterima menggunakan seat?

Pada paket dengan kumpulan seat terbatas, ya: undangan pending menahan satu seat. Menarik undangan atau membiarkannya kedaluwarsa akan membebaskan seat tersebut. Pada paket tanpa kumpulan seat, undangan tidak menggunakan apa pun.

Organisasi saya menggunakan single sign-on. Operasi mana yang berfungsi?

Jika penyedia identitas Anda memprovisikan pengguna secara otomatis (JIT atau SCIM), pembuatan undangan mengembalikan 400. Jika penyedia identitas mengelola peran (SSO lanjutan atau provisi SCIM lanjutan), pembaruan peran mengembalikan 400. Jika penyedia identitas mengelola keanggotaan (provisi SCIM), penghapusan anggota mengembalikan 400. Pembacaan tetap berfungsi dalam semua kasus.

Apa yang terjadi pada kunci Admin API ketika orang yang membuatnya keluar?

Kunci tersebut tetap berfungsi. Kunci Admin API dicakupkan ke organisasi, bukan ke pengguna individu, dan kunci yang dibuat di claude.ai tidak kedaluwarsa. Menghapus pembuatnya dari organisasi atau mencabut provisinya melalui penyedia identitas Anda mengakhiri akses mereka sendiri, tetapi tidak mengakhiri kunci yang mereka buat. Menurunkan peran mereka juga tidak mengubah kunci: setiap kunci tetap aktif dengan cakupan aslinya. Ketika Anda melakukan offboarding seseorang yang membuat kunci Admin API, hapus kunci tersebut di bagian Keys pada claude.ai > Organization settings > API dan buat penggantinya.

Lihat juga