API Plugin

Plugins API memungkinkan Anda menginventarisasi setiap plugin di organisasi Claude Enterprise Anda, memublikasikan plugin dan versi baru dari pipeline Anda sendiri, memilih versi mana yang disajikan kepada anggota, mengendalikan siapa yang dapat menggunakan setiap plugin, mengunduh file plugin untuk ditinjau, dan memeriksa marketplace Git sebelum Anda menghubungkannya.

Untuk pelaporan penggunaan plugin (plugin dan skill mana yang digunakan anggota, dan seberapa sering), lihat Analytics API.

Endpoint

API ini menyediakan 18 endpoint di lima sumber daya:

Rilis ini tidak mencakup skill mandiri (skill yang ditulis anggota di editor skill atau diunggah sebagai satu skill di claude.ai). Skill tersebut tidak muncul dalam inventaris dan tidak dapat dibuat di sini. Plugin yang dipublikasikan Anthropic juga tidak diinventarisasi; penggunaannya dilaporkan oleh Analytics API. Marketplace dibuat, dihubungkan ke repositori, dan dihapus di claude.ai, bukan melalui API ini.

Prasyarat

• Organisasi Anda harus menggunakan paket Claude Enterprise.
• Pemilik utama Anda membuat kunci Admin API dengan cakupan read:plugins, cakupan write:plugins, atau keduanya di claude.ai > Organization settings > API. Lihat Membuat kunci Admin API.
• Setiap permintaan membawa tiga header: x-api-key, anthropic-version: 2023-06-01, dan anthropic-beta: ce-plugins-2026-09-01.

SDK Python, TypeScript, C#, Go, Java, PHP, dan Ruby menyediakan endpoint ini di bawah client.beta.organization, dan CLI ant di bawah ant beta:organization; keduanya mengirimkan header anthropic-version dan anthropic-beta untuk Anda. Contoh di halaman ini menggunakan klien default setiap SDK, yang, seperti CLI, membaca kunci Admin API dari variabel lingkungan ANTHROPIC_API_KEY; contoh curl membaca kunci dari variabel yang sama dan meneruskannya di header x-api-key. Dalam contoh daftar Python, TypeScript, C#, Go, Java, dan Ruby serta di CLI, SDK mengambil halaman berikutnya saat Anda melakukan iterasi, sehingga limit menetapkan ukuran halaman, bukan total; contoh PHP dan curl mengembalikan satu halaman (lihat Paginasi).

Kunci API adalah milik organisasi dan tetap berfungsi setelah orang yang membuatnya keluar. Jangan bagikan kunci tersebut atau memasukkannya ke kontrol sumber.

Mulai cepat

Cantumkan plugin di marketplace milik organisasi Anda sendiri, dimulai dari yang terbaru:

client = anthropic.Anthropic()

plugins = client.beta.organization.plugins.list(owner_type="organization", limit=20)

# Secara otomatis mengambil halaman berikutnya sesuai kebutuhan.
for plugin in plugins:
    print(f"{plugin.id}: {plugin.name}")

{
  "data": [
    {
      "type": "plugin",
      "id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
      "name": "sales-toolkit",
      "display_name": "Sales Toolkit",
      "description": "Account research and call prep for the sales team.",
      "served_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
      "served_version_pinned": true,
      "latest_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
      "manifest_version": "1.4.0",
      "owner": { "type": "organization" },
      "marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
      "created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
      "organization_installation_preference": "available",
      "organization_installation_preference_inherited": true,
      "content_scan": { "status": "completed", "assessment": "pass", "reason": null },
      "components": [
        {
          "type": "skill",
          "name": "account-research",
          "description": "Researches a customer account before a call."
        },
        { "type": "mcp_server", "name": "crm", "description": null }
      ],
      "reach": "remote",
      "created_at": "2026-09-01T17:04:11Z",
      "updated_at": "2026-09-15T14:12:30Z"
    }
  ],
  "next_page": "page_xK9f2LqT7vNw3pRzBd8sHy"
}

Dalam contoh ini plugin disematkan ke versi sebelumnya: versi yang lebih baru (latest_version_id) sudah disimpan tetapi belum disajikan.

Cakupan

Sebuah kunci dapat membawa beberapa cakupan. Integrasi yang mengunggah plugin lalu membacanya kembali memerlukan read:plugins dan write:plugins. Di mana pun halaman ini menyatakan bahwa suatu endpoint memerlukan cakupan read:plugins, kunci dengan read:org_audit atau read:compliance_org_data juga berfungsi.

Akses ke file plugin anggota

Masing-masing cakupan baca ini (read:plugins, read:org_audit, dan read:compliance_org_data) dapat mengunduh file plugin di marketplace pribadi anggota, termasuk file yang tidak ditampilkan oleh pengaturan admin claude.ai, dan kunci read:org_audit atau read:compliance_org_data yang terikat ke organisasi induk Anda dapat melakukan hal ini di organisasi mana pun di bawahnya yang memiliki akses ke API ini, dengan meneruskan organization_id (lihat Membaca organisasi lain di bawah induk yang sama). Setiap unduhan tersebut mencatat peristiwa claude_plugin_archive_accessed di Activity Feed Compliance API, yang mengidentifikasi kunci, plugin, versi, dan anggota (lihat Peristiwa Activity Feed). Unduhan plugin milik organisasi tidak dicatat.

Membaca organisasi lain di bawah induk yang sama

Kunci read:plugins dan write:plugins hanya membaca dan menulis organisasi tempat kunci tersebut dibuat. Jika perusahaan Anda memiliki beberapa organisasi Claude yang ditautkan di bawah satu organisasi induk, kunci read:org_audit atau read:compliance_org_data yang dibuat oleh pemilik utama organisasi induk untuk semua organisasi tertaut (lihat Membuat kunci Admin API) juga dapat membaca organisasi mana pun di antaranya yang memiliki akses ke API ini: teruskan ID organisasi tersebut di parameter kueri organization_id pada endpoint GET mana pun di halaman ini. ID tersebut adalah UUID organisasi yang ditampilkan di pengaturan claude.ai (bentuk berawalan org_-nya juga diterima). Tanpa parameter tersebut, kunci membaca organisasi tempat kunci itu dibuat. 404 berarti organisasi yang disebutkan tidak berada di bawah induk kunci tersebut atau API tidak tersedia untuknya; nilai yang bukan UUID atau ID org_ mengembalikan 400. Kunci lain mana pun yang menyebutkan organisasi selain organisasinya sendiri mendapatkan 404. Operasi tulis tidak menerima organization_id.

Konsep utama

Plugin dan komponen

Plugin adalah paket yang memperluas Claude untuk anggota organisasi Anda. Plugin berisi kombinasi apa pun dari komponen berikut:

Setiap plugin memiliki manifest di .claude-plugin/plugin.json. name pada manifest menjadi name plugin: pengenal huruf kecil yang unik di dalam marketplace-nya.

Marketplace

Marketplace adalah wadah plugin. Setiap marketplace memiliki pemilik dan sumber.

• Pemilik. Organisasi memiliki marketplace-nya sendiri. Setiap anggota juga dapat memiliki marketplace pribadi.
• Sumber. manual berarti plugin diunggah, di claude.ai atau, untuk marketplace organisasi, melalui API ini. github, gitlab, dan public_git berarti plugin disinkronkan dari repositori Git yang dihubungkan oleh pemilik. Tidak ada yang dapat diunggah ke marketplace yang disinkronkan, dan API ini tidak dapat menghapus pluginnya, karena sinkronisasi berikutnya akan membatalkan perubahan mana pun. Sebagai gantinya, ubah repositorinya.

"Library marketplace" (marketplace pustaka) organisasi Anda adalah marketplace manual milik organisasi yang menjadi tujuan unggahan ketika Anda tidak menyebutkan marketplace. Marketplace ini dibuat saat pertama kali sesuatu diunggah ke sana.

Plugin milik organisasi dan milik anggota

owner.type pada plugin menyatakan di marketplace milik siapa plugin tersebut berada:

• organization: Anda dapat mengelolanya melalui API ini, kecuali bahwa plugin di marketplace yang disinkronkan dari Git tidak dapat menerima unggahan atau dihapus di sini.
• user: plugin berada di marketplace pribadi seorang anggota. Anda dapat membaca detailnya dan mengunduh filenya, serta menghapusnya jika marketplace-nya manual. Mengunggah versi dan memilih versi yang disajikan mengembalikan 403. Berbagi hanya dikelola oleh anggota tersebut, di claude.ai.

Menghapus anggota dari organisasi tidak menghapus plugin mereka. Plugin tersebut tetap ada di inventaris di bawah user_id anggota, dan filter owner_user_id masih menemukannya, sehingga Anda dapat meninjau dan menghapus konten anggota yang telah keluar. Plugin tersebut dihapus ketika akun anggota dihapus.

Versi dan versi yang disajikan

Setiap unggahan membuat versi baru yang tidak dapat diubah, baik berasal dari API ini, dari claude.ai, maupun dari sinkronisasi Git. Plugin memiliki dua penunjuk ke versinya:

• latest_version_id: versi terbaru.
• served_version_id: "served version" (versi yang disajikan), yaitu versi yang disajikan kepada anggota.

Secara default served_version_pinned bernilai false: versi yang disajikan mengikuti versi terbaru, dan setiap versi baru disajikan segera setelah disimpan.

Memilih versi dengan POST /v1/organizations/plugins/{plugin_id} akan menyematkan ("pin") plugin (served_version_pinned: true). Begitu pula ketika administrator memilih versi di claude.ai, atau menerima permintaan anggota untuk memublikasikan ke plugin tersebut. Sejak saat itu, unggahan baru disimpan dan memajukan latest_version_id, tetapi anggota tetap mendapatkan versi yang disematkan hingga Anda mengarahkan served_version_id ke versi lain. Plugin yang kedua penunjuknya berbeda memiliki versi tersimpan yang tidak sedang disajikan.

Hal ini memungkinkan pipeline rilis mengunggah setiap build, mengujinya, lalu mempromosikannya. Agar pipeline Anda yang menentukan kapan setiap build disajikan, sematkan plugin sekali dengan menetapkan served_version_id ke versinya saat ini; sejak saat itu, promosikan setiap build yang ingin Anda sajikan. Dengan pemindaian konten aktif, penyematan pertama tersebut mengembalikan 409 scan_pending hingga pemindaian versi saat ini selesai, dan 400 scan_failed jika pemindaian selesai dengan fail atau unknown, atau mengalami error (warn diterima). Plugin yang telah disematkan saat ini tidak dapat dilepas sematannya, baik di sini maupun di claude.ai.

Untuk melakukan rollback, tetapkan served_version_id ke versi sebelumnya. Maju ke versi yang lebih baru dengan cara yang sama.

Aturan ini menjelaskan plugin milik organisasi. Versi yang disajikan dari plugin milik anggota dikendalikan oleh pemiliknya di claude.ai.

Pengaturan instalasi

Pengaturan instalasi menentukan siapa yang dapat menggunakan plugin milik organisasi. Setiap pengaturan memiliki salah satu dari empat nilai, yang dibawa dalam field bernama installation_preference (dan, pada objek plugin dan marketplace, organization_installation_preference dan default_installation_preference):

Plugin dapat memiliki satu pengaturan tingkat organisasi dan satu pengaturan per grup (grup kontrol akses berbasis peran yang dikelola di Manajemen pengguna). Anggota mendapatkan nilai berdasarkan aturan berikut:

1. Nilai tingkat organisasi adalah pengaturan tingkat organisasi milik plugin itu sendiri jika ada, jika tidak maka default marketplace-nya, jika tidak maka not_available. Plugin melaporkan nilai ini di organization_installation_preference, dengan organization_installation_preference_inherited: true selama nilai tersebut berasal dari default marketplace.
2. Anggota yang tidak termasuk dalam grup mana pun yang memiliki pengaturan untuk plugin tersebut mendapatkan nilai tingkat organisasi.
3. Anggota yang termasuk dalam satu atau lebih grup yang memiliki pengaturan mendapatkan pengaturan paling permisif dari grup-grup tersebut sebagai gantinya, dengan urutan required, auto_install, available, not_available.

Pengaturan grup menggantikan nilai tingkat organisasi untuk anggotanya; pengaturan tersebut tidak menambahkannya. Misalnya, jika nilai tingkat organisasi adalah required dan grup Pilot memiliki available, anggota Pilot mendapatkan available. Saat Anda memindahkan plugin dari grup percontohan ke seluruh organisasi, tetapkan nilai tingkat organisasi lalu hapus pengaturan grup (menetapkan nilai tingkat organisasi secara permanen menghentikan plugin mewarisi default marketplace-nya, seperti yang dijelaskan di Menetapkan pengaturan instalasi).

Plugin yang dibuat melalui API ini dimulai tanpa pengaturannya sendiri, sehingga mewarisi default marketplace-nya: not_available kecuali seseorang telah menetapkan default. Menghapus grup akan menghapus pengaturannya dari setiap plugin.

Berbagi

"Shares" (berbagi) menentukan siapa yang dapat menggunakan plugin milik anggota. Pemilik membagikannya di claude.ai dengan setiap anggota, dengan grup, atau dengan anggota tertentu. API ini mencantumkan berbagi tetapi tidak dapat mengubahnya.

Jika organisasi Anda telah menonaktifkan suatu jenis berbagi di pengaturan claude.ai-nya, berbagi jenis tersebut tetap muncul dalam daftar tetapi tidak memberikan akses kepada siapa pun selama pengaturan tersebut nonaktif; daftar itu sendiri tidak menunjukkan apakah pengaturan tersebut nonaktif.

Pemindaian konten

"Content scanning" (pemindaian konten) adalah pengaturan organisasi di claude.ai. Saat aktif, versi yang baru disimpan akan dipindai (claude.ai mengecualikan beberapa) dan hasilnya dilaporkan di content_scan; versi yang tidak dipindai, misalnya versi yang disimpan sebelum pemindaian diaktifkan, memiliki content_scan: null. Pemindaian tidak ditawarkan kepada organisasi yang menggunakan kunci enkripsi yang dikelola pelanggan atau retensi data nol.

Selama pemindaian aktif, anggota hanya disajikan plugin ketika pemindaian versi yang disajikan berstatus completed dengan pass atau warn. Selama pemindaian berjalan, atau setelah pemindaian gagal, mengalami error, atau tidak mencapai putusan, plugin ditahan dari anggota, dan versi sebelumnya tidak disajikan sebagai gantinya. Versi yang tidak pernah dipindai (content_scan: null) disajikan secara normal.

Pada plugin yang tidak disematkan, setiap unggahan langsung menjadi versi yang disajikan. Anggota kehilangan plugin hingga pemindaian versi baru lolos, dan tetap tanpa plugin tersebut jika pemindaian gagal. Jika anggota harus tetap menggunakan versi saat ini selama versi baru dipindai, sematkan plugin terlebih dahulu (lihat Versi dan versi yang disajikan).

Setelah unggahan, content_scan.status bernilai processing dan putusan tiba secara asinkron. Baca versi tersebut untuk melihatnya; objek plugin hanya menampilkan pemindaian versi yang disajikan. Mengubah versi yang disajikan ke versi yang pemindaiannya masih berjalan mengembalikan 409 scan_pending; ke versi yang pemindaiannya gagal, 400 scan_failed.

Jangkauan

reach merangkum, dalam satu nilai, seberapa jauh jangkauan suatu versi di mesin anggota dan di luarnya:

reach memperhitungkan semua yang dideklarasikan versi tersebut, termasuk monitor, server LSP, dan pengaturan aplikasi, yang tidak dicantumkan oleh components, sehingga versi dengan daftar components kosong tetap dapat bernilai privileged. Nilainya null untuk versi yang disimpan sebelum komponen dicatat, dan untuk versi yang jangkauannya tidak dapat ditentukan karena salah satu file skill atau command-nya tidak dapat dibaca; perlakukan null sebagai tidak terklasifikasi.

Persyaratan unggahan

Unggahan mengikuti aturan yang sama dengan unggahan plugin di claude.ai, sehingga arsip yang sama diterima di kedua tempat.

• Unggahan berupa satu arsip .zip atau .plugin, atau sekumpulan file individual. Arsip dapat membungkus semuanya dalam satu folder tingkat atas.
• Unggahan harus berisi tepat satu manifest, di .claude-plugin/plugin.json, yang harus mendeklarasikan name. SKILL.md saja tanpa manifest akan ditolak.
• SKILL.md tingkat atas yang frontmatter-nya mendeklarasikan komponen plugin digabungkan ke dalam manifest; plugin.json yang berlaku di mana pun keduanya menetapkan nilai.
• name dapat berisi huruf kecil (dari alfabet apa pun), angka, dan tanda hubung, hingga 64 karakter. Huruf besar, spasi, garis bawah, dan tanda baca lainnya ditolak.
• displayName paling banyak 64 karakter dan description paling banyak 500.
• Setiap SKILL.md memerlukan frontmatter YAML yang valid dengan name dan description, yang keduanya tidak boleh berisi tag XML seperti <example>. Dua skill, atau dua command, tidak boleh memiliki nama yang sama.
• Tidak boleh ada file di bawah direktori bin/ tingkat atas.
• Tidak boleh ada file .zip bersarang. Server MCP terpaket (.mcpb, .dxt) diizinkan.
• Path file harus relatif, tidak berisi .., dan hanya menggunakan huruf, angka, spasi, dan _ . - / ( ) ,.
• Body permintaan dan arsip yang tidak terkompresi masing-masing paling besar 200 MB; body permintaan yang melebihi batas mengembalikan 413 (request_too_large), bukan 400. Unggahan memiliki paling banyak 5.000 file, kedalaman path 12, path sepanjang 472 karakter, dan nama file atau folder sepanjang 255 karakter.
• Arsip ZIP harus menggunakan kompresi DEFLATE atau STORE, dan tidak boleh dienkripsi atau berisi tautan simbolik.
• Marketplace menampung paling banyak 500 item, termasuk plugin-nya dan skill mandiri apa pun yang disimpan anggota di dalamnya. Batas ini dan batas 5.000 file adalah nilai saat ini yang dapat dinaikkan.

Contoh alur kerja

Publikasikan setiap build dari pipeline rilis

Unggah setiap build bertag dari CI, dan biarkan pipeline menentukan kapan suatu build disajikan.

1. Temukan marketplace tujuan unggahan dengan GET /v1/organizations/plugin_marketplaces?owner_type=organization, atau hilangkan marketplace_id untuk menggunakan library marketplace.
2. Pada rilis pertama, buat plugin dengan POST /v1/organizations/plugins. Pada setiap rilis berikutnya, catat latest_version_id plugin, lalu unggah versi dengan POST /v1/organizations/plugins/{plugin_id}/versions. Jika respons unggahan hilang, baca plugin dan coba lagi hanya jika latest_version_id tidak berubah (lihat Mencoba ulang unggahan).
3. Agar anggota tetap menggunakan versi saat ini selama setiap build baru diperiksa, sematkan plugin sekali dengan menetapkan served_version_id ke versinya saat ini. Sejak saat itu setiap unggahan disimpan tanpa disajikan, dan sematan tidak dapat dibatalkan: setiap build yang ingin Anda sajikan memerlukan langkah 5.
4. Saat pemindaian konten aktif, lakukan polling GET /v1/organizations/plugins/{plugin_id}/versions/{version} hingga content_scan.status tidak lagi processing, dan promosikan hanya jika nilainya completed dengan pass atau warn.
5. Promosikan build dengan POST /v1/organizations/plugins/{plugin_id} dan {"served_version_id": "<the new version's ID>"}. Untuk rollback, kirim ID versi sebelumnya dengan cara yang sama.

Luncurkan plugin ke grup percontohan, lalu ke semua orang

1. Cari ID grup percontohan dengan GET /v1/organizations/rbac_groups. Panggilan tersebut memerlukan cakupan read:rbac_groups, yang memerlukan kunci yang dibuat untuk semua organisasi tertaut (lihat Manajemen pengguna). Langkah-langkah berikutnya memerlukan write:plugins, yang hanya bertindak pada organisasi tempat kuncinya dibuat, jadi di perusahaan dengan beberapa organisasi tertaut, buat kunci ini di organisasi yang memiliki plugin tersebut dan berikan kedua cakupan, atau gunakan kunci kedua yang dibuat di sana untuk langkah-langkah tersebut.

2. Berikan grup pengaturannya sendiri, misalnya auto_install, dengan POST /v1/organizations/plugins/{plugin_id}/installation_settings/{target}, di mana {target} adalah ID rbac_group_ grup tersebut, sementara nilai tingkat organisasi tetap not_available. Hanya anggota grup yang mendapatkan plugin.

3. Saat masa percontohan berakhir, tetapkan nilai tingkat organisasi (ini secara permanen menghentikan plugin mewarisi default marketplace-nya, seperti yang dijelaskan di Menetapkan pengaturan instalasi), lalu hapus pengaturan grup agar grup kembali mengikuti organisasi:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   client = anthropic.Anthropic()
   
   setting = client.beta.organization.plugins.installation_settings.set(
       "organization",
       plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
       installation_preference="required",
   )
   
   print(f"plugin_id: {setting.plugin_id}")
   print(f"installation_preference: {setting.installation_preference}")

   Kemudian hapus pengaturan grup dengan DELETE /v1/organizations/plugins/{plugin_id}/installation_settings/{target}, di mana {target} adalah ID grup. Pengaturan grup menggantikan nilai tingkat organisasi untuk anggotanya alih-alih menambahkannya, sehingga pengaturan grup available yang tersisa akan membuat anggota tersebut tetap pada available.

Jaga inventaris keamanan tetap sinkron

Jalankan job malam hari yang menandai plugin yang menjangkau di luar sesi anggota atau gagal dalam pemindaian kontennya.

1. Telusuri halaman demi halaman GET /v1/organizations/plugins?limit=100 hingga next_page bernilai null, dengan meneruskan sendiri next_page setiap halaman sebagai page alih-alih menggunakan iterator daftar SDK, yang dapat berhenti lebih awal pada daftar ini (lihat Paginasi). Baca reach dan content_scan setiap plugin dari daftar tersebut pada setiap eksekusi: putusan pemindaian yang tiba belakangan tidak mengubah updated_at. updated_at memberi tahu Anda plugin mana yang memiliki konten baru atau versi yang disajikan baru sejak eksekusi terakhir (layak untuk diunduh ulang arsipnya); pencantuman ulang secara penuh juga yang menangkap penghapusan, karena plugin yang dihapus oleh sinkronisasi Git atau penghapusan akun menghilang tanpa peristiwa.
2. Tandai setiap plugin yang reach-nya remote (mendeklarasikan server MCP atau CLI), atau yang content_scan.assessment-nya fail atau unknown.
3. Untuk setiap plugin yang ditandai, unduh arsip versi yang disajikan untuk ditinjau dengan GET /v1/organizations/plugins/{plugin_id}/versions/{served_version_id}/content (lihat Mengunduh file suatu versi).
4. Untuk menarik plugin dari anggota selama Anda meninjaunya, lihat Menghapus plugin untuk opsi yang dapat dibatalkan (milik organisasi) dan yang permanen.

Plugin

Objek plugin menjelaskan plugin di salah satu marketplace organisasi Anda atau di marketplace pribadi anggota (respons Mulai cepat menunjukkan contoh lengkapnya). display_name, description, manifest_version, content_scan, components, dan reach-nya menjelaskan versi yang disajikan, sehingga satu panggilan daftar menunjukkan apa yang sedang disajikan kepada anggota.

Objek content_scan:

plugin_id yang tidak memiliki awalan plugin_ mengembalikan 400. plugin_id yang memiliki awalan tersebut tetapi tidak dapat di-resolve, milik organisasi lain, atau merujuk ke skill mandiri mengembalikan 404.

Daftar plugin

GET /v1/organizations/plugins mencantumkan setiap plugin di organisasi Anda, di marketplace organisasi dan di marketplace pribadi anggota, diurutkan berdasarkan created_at secara menurun. Filter berdasarkan owner_type (organization atau user), owner_user_id (berawalan user_; plugin milik seorang anggota, termasuk setelah anggota tersebut keluar dari organisasi), marketplace_id, dan created_at[gte], created_at[gt], created_at[lte], created_at[lt] (timestamp RFC 3339). Filter digabungkan dengan AND. marketplace_id atau owner_user_id yang tidak cocok dengan apa pun di organisasi Anda mengembalikan halaman kosong, bukan error. Respons memiliki bentuk yang ditunjukkan di Mulai cepat. Memerlukan cakupan read:plugins.

client = anthropic.Anthropic()

plugins = client.beta.organization.plugins.list(owner_type="organization", limit=20)

# Secara otomatis mengambil halaman berikutnya sesuai kebutuhan.
for plugin in plugins:
    print(f"{plugin.id}: {plugin.name}")

Membuat plugin

POST /v1/organizations/plugins membuat plugin milik organisasi beserta versi pertamanya dalam satu panggilan; versi tersebut menjadi "served version" (versi yang disajikan). Body berupa multipart/form-data: files[] berisi satu arsip .zip atau .plugin, atau satu part per file, dengan nama file setiap part berupa path file tersebut di dalam plugin (misalnya .claude-plugin/plugin.json). Field opsionalnya adalah marketplace_id (marketplace manual milik organisasi; default-nya adalah marketplace library Anda, yang dibuat saat pertama kali digunakan) dan release_notes (hingga 5.000 karakter, ditampilkan di riwayat versi claude.ai dan dikembalikan pada versi). name, display_name, description, dan manifest_version plugin diambil dari manifest yang diunggah, dan unggahan harus memenuhi persyaratan unggahan. Saat pemindaian konten aktif, content_scan.status pada respons bernilai processing dan hasil pemindaiannya tiba secara asinkron. Mengembalikan plugin. Memerlukan scope write:plugins.

Mengunggah arsip:

client = anthropic.Anthropic()

with open("dist/sales-toolkit.zip", "rb") as archive:
    plugin = client.beta.organization.plugins.create(
        files=[archive],
        release_notes="First release",
    )

print(f"id: {plugin.id}")
print(f"served_version_id: {plugin.served_version_id}")

{
  "type": "plugin",
  "id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
  "name": "sales-toolkit",
  "display_name": "Sales Toolkit",
  "description": "Account research and call prep for the sales team.",
  "served_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
  "served_version_pinned": false,
  "latest_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
  "manifest_version": "1.4.0",
  "owner": { "type": "organization" },
  "marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
  "created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
  "organization_installation_preference": "available",
  "organization_installation_preference_inherited": true,
  "content_scan": { "status": "processing", "assessment": null, "reason": null },
  "components": [
    {
      "type": "skill",
      "name": "account-research",
      "description": "Researches a customer account before a call."
    },
    { "type": "mcp_server", "name": "crm", "description": null }
  ],
  "reach": "remote",
  "created_at": "2026-09-01T17:04:11Z",
  "updated_at": "2026-09-01T17:04:11Z"
}

Mengunggah file satu per satu ke marketplace tertentu. Lampirkan setiap file dengan path-nya di dalam plugin (sufiks ;filename= pada contoh cURL, argumen nama file pada contoh SDK); file yang dikirim hanya dengan nama dasarnya akan membuat manifest tidak ditemukan. SDK TypeScript dan Java serta CLI ant belum dapat melampirkan file dengan path, sehingga contoh-contoh tersebut mengunggah plugin sebagai satu arsip ke marketplace:

client = anthropic.Anthropic()

# Tuple (filename, file) mempertahankan path setiap file di dalam plugin;
# objek file biasa hanya akan dikirim dengan nama dasarnya saja.
with (
    open(".claude-plugin/plugin.json", "rb") as manifest,
    open("skills/account-research/SKILL.md", "rb") as skill_md,
):
    plugin = client.beta.organization.plugins.create(
        files=[
            (".claude-plugin/plugin.json", manifest),
            ("skills/account-research/SKILL.md", skill_md),
        ],
        marketplace_id="marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
    )

print(f"id: {plugin.id}")
print(f"served_version_id: {plugin.served_version_id}")

Selain 400 untuk unggahan yang melanggar persyaratan unggahan (413 untuk body permintaan lebih dari 200 MB) dan respons bersama (403 ketika marketplace_id adalah marketplace pribadi milik anggota; lihat Respons error), pembuatan plugin dapat gagal dengan:

Mendapatkan plugin

GET /v1/organizations/plugins/{plugin_id} mengembalikan satu plugin. Memerlukan scope read:plugins.

client = anthropic.Anthropic()

plugin = client.beta.organization.plugins.retrieve("plugin_01Hq3vX8kZcN2mB7pR4tY9wL")

print(f"id: {plugin.id}")
print(f"name: {plugin.name}")

Mengubah versi yang disajikan

POST /v1/organizations/plugins/{plugin_id} mengubah versi plugin milik organisasi yang disajikan kepada anggota. Berikan versi yang lebih lama untuk melakukan rollback, atau versi yang lebih baru untuk mempromosikan build yang disimpan tanpa disajikan. Tindakan ini menyematkan ("pin") plugin, dan plugin yang disematkan saat ini tidak dapat dilepas sematannya, baik di sini maupun di claude.ai (lihat Versi dan versi yang disajikan). Satu-satunya field yang dapat diperbarui adalah served_version_id, dan field ini wajib. Perubahan sampai ke anggota sebelum respons dikembalikan dan tidak membuat versi baru. Saat pemindaian konten aktif, versi tersebut harus merupakan versi yang boleh disajikan kepada anggota (lihat Pemindaian konten). Memberikan versi yang sudah disajikan pada plugin yang disematkan tidak mengubah apa pun; memberikannya pada plugin yang tidak disematkan akan menyematkan plugin pada versi tersebut, sehingga unggahan berikutnya tidak lagi disajikan secara otomatis. Mengembalikan plugin. Memerlukan scope write:plugins.

client = anthropic.Anthropic()

plugin = client.beta.organization.plugins.update(
    "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
    served_version_id="pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
)

print(f"id: {plugin.id}")
print(f"served_version_id: {plugin.served_version_id}")

{
  "type": "plugin",
  "id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
  "name": "sales-toolkit",
  "display_name": "Sales Toolkit",
  "description": "Account research and call prep for the sales team.",
  "served_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
  "served_version_pinned": true,
  "latest_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
  "manifest_version": "1.5.0",
  "owner": { "type": "organization" },
  "marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
  "created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
  "organization_installation_preference": "available",
  "organization_installation_preference_inherited": true,
  "content_scan": { "status": "completed", "assessment": "pass", "reason": null },
  "components": [
    {
      "type": "skill",
      "name": "account-research",
      "description": "Researches a customer account before a call."
    },
    { "type": "mcp_server", "name": "crm", "description": null },
    {
      "type": "command",
      "name": "call-prep",
      "description": "Builds a one-page brief for an upcoming call."
    }
  ],
  "reach": "remote",
  "created_at": "2026-09-01T17:04:11Z",
  "updated_at": "2026-09-16T10:02:45Z"
}

Selain respons bersama (403 untuk plugin milik anggota, serta 409 scan_pending atau 400 scan_failed untuk versi yang tidak boleh disajikan kepada anggota; lihat Respons error), permintaan dapat gagal dengan:

Menghapus plugin

DELETE /v1/organizations/plugins/{plugin_id} menghapus plugin secara permanen beserta setiap versi yang dimilikinya, sama seperti penghapusan oleh administrator di claude.ai. Endpoint ini berfungsi untuk plugin apa pun di marketplace manual, termasuk plugin milik anggota, bahkan jika anggota tersebut telah keluar dari organisasi. Saat penghapusan selesai, plugin, versinya, dan file-filenya hilang dari setiap pembacaan, dan plugin tersebut tidak lagi disajikan kepada anggota. Pengaturan instalasi plugin milik organisasi ikut dihapus; pembagian plugin milik anggota ditarik, dan plugin tersebut juga hilang bagi pemiliknya. Plugin di marketplace yang disinkronkan dari Git mengembalikan 400: hapus plugin tersebut dari repositori, atau hapus marketplace di claude.ai. Memerlukan scope write:plugins.

Penghapusan tidak dapat dibatalkan, dan tidak ada penghapusan per versi. Untuk menahan plugin milik organisasi secara reversibel, atur pengaturan instalasi tingkat organisasinya ke not_available (plugin yang sebelumnya mewarisi default marketplace-nya akan memiliki pengaturannya sendiri sejak saat itu), lalu hapus (atau atur ke not_available) setiap pengaturan grup yang dicantumkan oleh GET /v1/organizations/plugins/{plugin_id}/installation_settings, karena pengaturan grup menimpa nilai tingkat organisasi bagi anggotanya. Kirim penulisan ini satu per satu, bukan secara paralel (lihat Menetapkan pengaturan instalasi). Plugin milik anggota tidak dapat ditahan melalui API ini kecuali dengan menghapusnya, dan hanya jika marketplace-nya bertipe manual.

client = anthropic.Anthropic()

deleted_plugin = client.beta.organization.plugins.delete(
    "plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
)

print(f"id: {deleted_plugin.id}")

{ "type": "plugin_deleted", "id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL" }

Versi plugin

Versi plugin adalah snapshot yang tidak dapat diubah ("immutable") dari file-file plugin dari satu unggahan (respons Membuat versi menampilkan objek lengkapnya). Field-fieldnya mencerminkan field versi yang disajikan pada plugin (display_name, description, manifest_version, content_scan, components, reach) untuk versi ini, ditambah release_notes (sebagaimana diberikan saat unggahan; ditampilkan di riwayat versi claude.ai) dan created_by (siapa yang mengunggahnya).

{version} yang tidak memiliki prefiks pluginver_ mengembalikan 400 (kecuali literal latest jika disebutkan). Nilai yang memiliki prefiks tersebut tetapi tidak mengidentifikasi versi dari plugin itu mengembalikan 404.

Mencantumkan versi plugin

GET /v1/organizations/plugins/{plugin_id}/versions mencantumkan versi-versi plugin, diurutkan berdasarkan created_at secara menurun; item pertama adalah versi yang diidentifikasi oleh latest_version_id. limit bernilai 1 hingga 1.000. Memerlukan scope read:plugins.

client = anthropic.Anthropic()

versions = client.beta.organization.plugins.versions.list(
    "plugin_01Hq3vX8kZcN2mB7pR4tY9wL", limit=50
)

# Secara otomatis mengambil halaman berikutnya sesuai kebutuhan.
for version in versions:
    print(f"{version.id}: {version.manifest_version}")

Membuat versi

POST /v1/organizations/plugins/{plugin_id}/versions menambahkan versi ke plugin milik organisasi di marketplace manual. Body berupa multipart/form-data, dengan field files[] dan release_notes, persyaratan unggahan, serta error file, manifest, arsip, dan ukuran yang sama seperti Membuat plugin. Nama yang diunggah (name pada manifest) harus sama dengan name plugin. Jika plugin tidak disematkan, versi baru langsung disajikan begitu disimpan; jika disematkan, versi tersebut disimpan tetapi tidak disajikan sampai Anda mengubah versi yang disajikan ke versi itu. Untuk memeriksanya, bandingkan id pada respons dengan served_version_id plugin. Mengembalikan versi. Memerlukan scope write:plugins.

client = anthropic.Anthropic()

with open("dist/sales-toolkit.zip", "rb") as archive:
    version = client.beta.organization.plugins.versions.create(
        "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
        files=[archive],
        release_notes="Adds the call-prep command.",
    )

print(f"id: {version.id}")
print(f"manifest_version: {version.manifest_version}")

{
  "type": "plugin_version",
  "id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
  "plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
  "display_name": "Sales Toolkit",
  "description": "Account research and call prep for the sales team.",
  "manifest_version": "1.5.0",
  "release_notes": "Adds the call-prep command.",
  "created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
  "content_scan": { "status": "processing", "assessment": null, "reason": null },
  "components": [
    {
      "type": "skill",
      "name": "account-research",
      "description": "Researches a customer account before a call."
    },
    { "type": "mcp_server", "name": "crm", "description": null },
    {
      "type": "command",
      "name": "call-prep",
      "description": "Builds a one-page brief for an upcoming call."
    }
  ],
  "reach": "remote",
  "created_at": "2026-09-15T14:12:30Z"
}

Selain 400 untuk unggahan yang melanggar persyaratan unggahan (413 untuk body permintaan lebih dari 200 MB) dan respons bersama (403 untuk plugin milik anggota; lihat Respons error), permintaan dapat gagal dengan:

Mendapatkan versi

GET /v1/organizations/plugins/{plugin_id}/versions/{version} mengembalikan satu versi. {version} adalah ID versi, atau latest untuk versi yang diidentifikasi oleh latest_version_id pada saat permintaan. Memerlukan scope read:plugins.

client = anthropic.Anthropic()

version = client.beta.organization.plugins.versions.retrieve(
    "latest",
    plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
)

print(f"id: {version.id}")
print(f"manifest_version: {version.manifest_version}")

Mengunduh file versi

GET /v1/organizations/plugins/{plugin_id}/versions/{version}/content mengunduh file-file suatu versi sebagai arsip .zip yang tersimpan (Content-Type: application/zip). Arsip dikembalikan apa pun hasil pemindaian kontennya, sehingga Anda dapat memeriksa versi yang ditahan dari anggota. Arsip disajikan persis seperti yang disimpan, sehingga untuk plugin milik organisasi di marketplace manual Anda dapat mengunggahnya kembali tanpa perubahan sebagai versi baru, asalkan memenuhi persyaratan unggahan saat ini. {version} harus berupa ID versi, bukan latest: baca terlebih dahulu served_version_id atau latest_version_id plugin, atau resolusikan latest dengan GET /v1/organizations/plugins/{plugin_id}/versions/latest. Nama file pada Content-Disposition diturunkan dari nama plugin dan tidak unik; beri nama file yang disimpan berdasarkan ID plugin dan ID versi. Memerlukan scope read:plugins.

Mengunduh arsip plugin milik anggota mencatat event claude_plugin_archive_accessed pada Activity Feed Compliance API, yang mengidentifikasi kunci (sebagai api_actor), plugin dan marketplace-nya, versi, serta anggota pemilik berdasarkan ID; event ini tidak memuat nama. Mengunduh arsip plugin milik organisasi tidak mencatat apa pun.

client = anthropic.Anthropic()

plugin_id = "plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
version_id = "pluginver_01Km7tL4pR9xF5sU2zV3jP6q"

with client.beta.organization.plugins.versions.with_streaming_response.download(
    version_id,
    plugin_id=plugin_id,
) as response:
    response.stream_to_file(f"{plugin_id}_{version_id}.zip")

Pengaturan instalasi plugin

Endpoint-endpoint ini berlaku untuk plugin milik organisasi. Endpoint ini mengembalikan 404 untuk plugin milik anggota, yang memiliki pembagian sebagai gantinya. {target} adalah literal organization untuk pengaturan tingkat organisasi plugin, atau ID rbac_group_ suatu grup untuk pengaturan grup tersebut; nilai lain mengembalikan 400. ID grup diperoleh dari GET /v1/organizations/rbac_groups (scope read:rbac_groups; lihat Manajemen pengguna). Pengaturan tidak memiliki id sendiri: pengaturan dialamatkan dengan (plugin_id, target), dan tidak ada aktor yang dicatat padanya (aktor tercatat pada event aktivitas plugin_installation_preference_updated).

Mencantumkan pengaturan instalasi plugin

GET /v1/organizations/plugins/{plugin_id}/installation_settings mencantumkan pengaturan yang dimiliki plugin milik organisasi, diurutkan berdasarkan created_at secara menurun: pengaturan tingkat organisasinya sendiri (tidak ada selama plugin mewarisi default marketplace-nya) dan pengaturan setiap grup. Filter berdasarkan target_type (organization atau rbac_group). Memerlukan scope read:plugins.

client = anthropic.Anthropic()

settings = client.beta.organization.plugins.installation_settings.list(
    "plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
)

# Secara otomatis mengambil halaman berikutnya sesuai kebutuhan.
for setting in settings:
    print(f"{setting.plugin_id}: {setting.installation_preference}")

Menetapkan pengaturan instalasi

POST /v1/organizations/plugins/{plugin_id}/installation_settings/{target} menetapkan pengaturan instalasi satu target untuk plugin milik organisasi, dengan membuatnya atau mengubah nilai yang sudah dimilikinya. Satu-satunya field pada body adalah installation_preference (required, auto_install, available, atau not_available), dan field ini wajib. Menetapkan nilai yang sudah dimiliki target tidak mengubah apa pun. Menetapkan target organization membuat plugin berhenti mewarisi default marketplace-nya (organization_installation_preference_inherited menjadi false), bahkan ketika nilainya sama dengan default; hal ini tidak dapat dibatalkan, karena pengaturan tingkat organisasi tidak dapat dihapus, sehingga plugin tidak lagi mengikuti perubahan default marketplace selanjutnya. Target grup harus berupa grup yang dapat dilihat organisasi Anda di GET /v1/organizations/rbac_groups, jika tidak permintaan mengembalikan 404. Perubahan ini tidak mengubah updated_at plugin; perubahan dicatat di Activity Feed. Mengembalikan pengaturan. Memerlukan scope write:plugins.

Kirim penulisan pengaturan instalasi untuk suatu plugin satu per satu. Jika beberapa penulisan untuk plugin yang sama tiba bersamaan, server menanganinya satu per satu dan dapat menjawab sebagian di antaranya dengan 503 alih-alih menerapkannya. 503 tersebut menyertakan x-should-retry: true, dan penulisan tersebut aman untuk diulang: tunggu satu atau dua detik, lalu kirim lagi.

client = anthropic.Anthropic()

setting = client.beta.organization.plugins.installation_settings.set(
    "rbac_group_01F3xQqQzXyWvUtSrQpOnMlK",
    plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
    installation_preference="available",
)

print(f"plugin_id: {setting.plugin_id}")
print(f"installation_preference: {setting.installation_preference}")

{
  "type": "plugin_installation_setting",
  "plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
  "target": { "type": "rbac_group", "rbac_group_id": "rbac_group_01F3xQqQzXyWvUtSrQpOnMlK" },
  "installation_preference": "available",
  "created_at": "2026-09-02T10:00:00Z",
  "updated_at": "2026-09-02T10:00:00Z"
}

Menghapus pengaturan instalasi grup

DELETE /v1/organizations/plugins/{plugin_id}/installation_settings/{target} menghapus pengaturan satu grup untuk plugin milik organisasi. Anggota grup tersebut kembali menggunakan nilai tingkat organisasi, atau pengaturan dari grup lain tempat mereka bergabung. Pengaturan tingkat organisasi tidak dapat dihapus setelah ditetapkan, sama seperti di claude.ai ({target} bernilai organization mengembalikan 400); ubah nilainya sebagai gantinya. Grup yang tidak memiliki pengaturan untuk plugin ini mengembalikan 404. Respons menyertakan kunci komposit sebagai pengganti id. Memerlukan scope write:plugins.

client = anthropic.Anthropic()

removed_setting = client.beta.organization.plugins.installation_settings.remove(
    "rbac_group_01F3xQqQzXyWvUtSrQpOnMlK",
    plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
)

print(f"plugin_id: {removed_setting.plugin_id}")

{
  "type": "plugin_installation_setting_deleted",
  "plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
  "target": { "type": "rbac_group", "rbac_group_id": "rbac_group_01F3xQqQzXyWvUtSrQpOnMlK" }
}

Pembagian plugin

Pembagian ("share") hanya ada pada plugin milik anggota dan bersifat hanya-baca di API ini (lihat Pembagian).

Mencantumkan pembagian plugin

GET /v1/organizations/plugins/{plugin_id}/shares mencantumkan pihak-pihak yang telah diberi akses oleh pemilik plugin milik anggota, diurutkan berdasarkan granted_at secara menurun: setiap anggota (organization), sebuah grup (rbac_group), atau anggota tertentu (organization_member). Filter berdasarkan target_type. Plugin yang belum dibagikan oleh pemiliknya mengembalikan daftar kosong; plugin milik organisasi mengembalikan 404. Pembagian bersifat hanya-baca di API ini, dan pembagian yang tercantum hanya memberikan akses selama jenis pembagian tersebut diaktifkan untuk organisasi Anda di claude.ai (lihat Pembagian). granted_at adalah waktu pembagian diberikan; jika pemilik kemudian mengubah pembagian tersebut di claude.ai, nilainya adalah waktu perubahan itu. Memerlukan scope read:plugins.

client = anthropic.Anthropic()

shares = client.beta.organization.plugins.shares.list("plugin_01Mr2wP7sU3aJ8vX5cY6nS9t")

# Secara otomatis mengambil halaman berikutnya sesuai kebutuhan.
for share in shares:
    print(f"plugin_id: {share.plugin_id}")

{
  "data": [
    {
      "type": "plugin_share",
      "plugin_id": "plugin_01Mr2wP7sU3aJ8vX5cY6nS9t",
      "target": { "type": "organization_member", "user_id": "user_01WCz9BvGLdMYRUMmcAxMWvW" },
      "granted_at": "2026-08-20T15:12:00Z"
    }
  ],
  "next_page": null
}

Marketplace plugin

API ini membaca marketplace dan menetapkan pengaturan instalasi default marketplace organisasi; marketplace itu sendiri dibuat, dihubungkan ke repositori, dan dihapus di claude.ai.

{
  "type": "plugin_marketplace",
  "id": "marketplace_01VbNcMxZaSdFgHjKlQwErTy",
  "name": "engineering-tools",
  "owner": { "type": "organization" },
  "source": "github",
  "sync_status": "success",
  "last_sync_ended_at": "2026-09-10T22:15:03Z",
  "last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
  "default_installation_preference": "available",
  "created_at": "2026-06-12T08:45:00Z"
}

marketplace_id yang tidak memiliki prefiks marketplace_ mengembalikan 400. Nilai yang memiliki prefiks tersebut tetapi tidak dapat diresolusikan, atau milik organisasi lain, mengembalikan 404.

Mencantumkan marketplace

GET /v1/organizations/plugin_marketplaces mencantumkan marketplace organisasi Anda dan marketplace pribadi anggota, diurutkan berdasarkan created_at secara menurun. Gunakan endpoint ini untuk menemukan ID marketplace, untuk memfilter daftar plugin berdasarkan marketplace tersebut atau untuk mengunggah ke dalamnya, sebelum marketplace itu berisi plugin apa pun. Marketplace library muncul setelah sesuatu pertama kali dibuat di dalamnya, di claude.ai atau melalui API ini. Filter berdasarkan owner_type (organization atau user) dan source. limit bernilai 1 hingga 1.000. Memerlukan scope read:plugins.

client = anthropic.Anthropic()

marketplaces = client.beta.organization.plugin_marketplaces.list(
    owner_type="organization"
)

# Secara otomatis mengambil halaman berikutnya sesuai kebutuhan.
for marketplace in marketplaces:
    print(f"{marketplace.id}: {marketplace.name}")

Mendapatkan marketplace

GET /v1/organizations/plugin_marketplaces/{marketplace_id} mengembalikan satu marketplace. Memerlukan scope read:plugins.

client = anthropic.Anthropic()

marketplace = client.beta.organization.plugin_marketplaces.retrieve(
    "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r"
)

print(f"id: {marketplace.id}")
print(f"name: {marketplace.name}")

Menetapkan pengaturan instalasi default marketplace

POST /v1/organizations/plugin_marketplaces/{marketplace_id} menetapkan pengaturan instalasi default dari marketplace milik organisasi. Setiap plugin di marketplace yang tidak memiliki pengaturan tingkat organisasinya sendiri melaporkan default ini sebagai organization_installation_preference-nya, termasuk plugin yang ditambahkan kemudian. Endpoint ini berfungsi untuk marketplace manual maupun yang disinkronkan; marketplace pribadi milik anggota mengembalikan 403. Satu-satunya field yang dapat diperbarui adalah default_installation_preference, dan field ini wajib. Nilainya tidak dapat dikembalikan ke null: setelah marketplace memiliki default, marketplace tersebut akan tetap memilikinya, seperti di claude.ai. Perubahan dicatat sebagai satu event marketplace_updated tanpa event per plugin, dan tidak mengubah updated_at plugin mana pun. Menetapkan nilai yang sudah ditetapkan tidak mengubah apa pun, dengan satu pengecualian: marketplace yang default-nya belum pernah ditetapkan melaporkan not_available tetapi tidak memiliki pengaturan, sehingga penulisan pertamanya (bahkan not_available) dihitung sebagai perubahan. Mengembalikan marketplace. Memerlukan scope write:plugins.

client = anthropic.Anthropic()

marketplace = client.beta.organization.plugin_marketplaces.update(
    "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
    default_installation_preference="available",
)

print(f"id: {marketplace.id}")
print(f"default_installation_preference: {marketplace.default_installation_preference}")

Memvalidasi konten marketplace

Dua endpoint melaporkan apa yang akan dilakukan sinkronisasi terhadap konten marketplace yang diberikan, tanpa menghubungkan atau menyimpan apa pun: POST /v1/organizations/plugin_marketplaces/validate_repository membaca repositori GitHub publik, dan POST /v1/organizations/plugin_marketplaces/validate_archive membaca .zip dari direktori marketplace yang Anda unggah. Keduanya mengembalikan laporan yang sama: apakah marketplace.json terbentuk dengan benar, plugin mana yang akan dilewati dan alasannya, serta plugin mana yang akan disinkronkan dengan sebagian kontennya tidak disertakan. Pemeriksaan yang dilakukan sama dengan yang dijalankan oleh sinkronisasi sebenarnya. Masalah pada konten dikembalikan dalam laporan, bukan sebagai error HTTP: permintaan berhasil dengan valid: false, bahkan ketika repositori atau arsip sama sekali tidak dapat dibaca. Validasi dihitung sebagai pembacaan, dan kedua endpoint tersebut secara bersama-sama juga dibatasi hingga 10 validasi per menit per organisasi (lihat Pembatasan laju); keduanya tidak mencatat apa pun di Activity Feed. Validasi dapat memakan waktu hingga 120 detik sebelum kembali, jadi atur timeout klien Anda di atas nilai tersebut. Kedua endpoint memerlukan scope read:plugins atau write:plugins (read:org_audit dan read:compliance_org_data tidak memberikan akses tersebut).

Repositori, dan sumber plugin apa pun di luarnya yang berada di GitHub, dibaca secara anonim, sehingga repositori privat atau sumber plugin privat dilaporkan sebagai tidak ditemukan. Sumber plugin di host selain GitHub tidak diambil; plugin semacam itu biasanya mendapat peringatan marketplace_validate_source_not_checked dan diperiksa saat marketplace benar-benar disinkronkan. Jika repositori tersebut adalah, atau arsip tersebut menyebutkan, marketplace yang disinkronkan Anthropic ke setiap organisasi, aturan yang lebih ketat berlaku: setiap sumber plugin di luar marketplace harus disematkan ke SHA commit lengkap, sumber yang tidak disematkan atau berada di host yang tidak didukung dilaporkan sebagai error plugin, dan branch yang dibaca secara default adalah branch yang menjadi sumber sinkronisasi marketplace tersebut.

validate_repository menerima body JSON dengan dua field: repository_url, URL https:// dari repositori publik di github.com (wajib), dan ref, nama branch atau SHA commit lengkap 40 karakter (opsional; jika dihilangkan atau null, digunakan branch yang akan dibaca oleh sinkronisasi, biasanya branch default repositori). validate_archive menerima multipart/form-data dengan tepat satu part, archive, yang dikirim sebagai part file dengan nama file: .zip dari direktori marketplace, maksimal 32 MB, dengan isinya berada di root atau dibungkus dalam satu folder (seperti yang dihasilkan oleh unduhan dari host Git), hanya dengan kompresi DEFLATE atau STORE. Tidak ada field formulir lain yang diterima.

Memvalidasi repositori publik pada suatu branch:

client = anthropic.Anthropic()

report = client.beta.organization.plugin_marketplaces.validate_repository(
    repository_url="https://github.com/example-org/claude-plugins",
    ref="release-candidate",
)

print(f"valid: {str(report.valid).lower()}")
print(f"total_plugin_count: {report.total_plugin_count}")

{
  "type": "plugin_marketplace_validation_report",
  "valid": false,
  "ref": "release-candidate",
  "commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
  "total_plugin_count": 3,
  "manifest_error": null,
  "manifest_error_code": null,
  "plugin_errors": [
    {
      "name": "deploy-helper",
      "error": "The plugin has a top-level bin/ directory.",
      "error_code": "marketplace_sync_bin_directory_not_allowed"
    }
  ],
  "plugin_warnings": [
    {
      "name": "release-notes",
      "warnings": [
        {
          "message": "plugin.json has unrecognized top-level keys: owners",
          "error_code": "marketplace_sync_plugin_unrecognized_keys"
        }
      ]
    }
  ]
}

Sebagai alternatif, validasi salinan lokal direktori marketplace sebagai .zip; responsnya berupa laporan yang sama:

client = anthropic.Anthropic()

with open("marketplace.zip", "rb") as archive:
    report = client.beta.organization.plugin_marketplaces.validate_archive(
        archive=archive
    )

print(f"valid: {str(report.valid).lower()}")
print(f"total_plugin_count: {report.total_plugin_count}")

Masalah pada konten tidak pernah membuat permintaan gagal. Selain respons yang dimiliki bersama oleh setiap endpoint (403 untuk kunci yang hanya memiliki read:org_audit atau read:compliance_org_data; lihat Respons error dan Pembatasan laju), permintaan itu sendiri dapat gagal dengan:

Kode laporan

Setiap temuan dalam laporan memiliki kode yang stabil: manifest_error_code ketika tidak ada yang dapat divalidasi, error_code pada setiap entri plugin_errors, dan error_code pada setiap peringatan. Ketika sebuah plugin memiliki beberapa masalah, error_code adalah kode masalah pertama dan error menggabungkan pesan-pesannya. Kode baru dapat ditambahkan; manifest_error_code yang tidak dikenali tetap berarti konten tidak dapat divalidasi, kode yang tidak dikenali pada entri plugin_errors tetap berarti plugin akan dilewati, dan kode yang tidak dikenali pada peringatan tetap berarti plugin akan disinkronkan. Kode-kode berikut menunjukkan kondisi sementara, sehingga permintaan yang sama mungkin berhasil nanti: marketplace_host_rate_limited, marketplace_host_server_error, marketplace_host_timeout, marketplace_host_unreachable, marketplace_repo_access_denied, marketplace_sync_transient_fetch_budget_exhausted, marketplace_validate_network_error, dan biasanya marketplace_validate_deadline_exceeded.

Nilai yang tidak dikenali

Setiap nilai string di halaman ini (tipe komponen, reach, field pemindaian, source marketplace, kode error) dapat memperoleh nilai baru kapan saja. Perlakukan nilai yang tidak Anda kenali seperti string tak dikenal lainnya, alih-alih membuat proses gagal.

Pembatasan laju

Permintaan baca (setiap endpoint GET di halaman ini) berbagi "rate limit" (batas laju) sebesar 300 permintaan per menit per organisasi, dan permintaan tulis (membuat plugin atau versi, mengubah versi yang disajikan, menghapus, menetapkan atau menghapus pengaturan instalasi, dan memperbarui marketplace) berbagi batas sebesar 60 permintaan per menit per organisasi. Validasi marketplace (endpoint mana pun) dihitung sebagai pembacaan, dan validasi juga dibatasi hingga 10 per menit per organisasi untuk kedua endpoint secara gabungan; kedua batas diperiksa sebelum body permintaan dibaca. Batas-batas ini dihitung untuk semua kunci organisasi Anda dan terpisah dari batas Admin API lainnya milik organisasi Anda. Permintaan yang melebihi batas mengembalikan 429 Too Many Requests dengan header retry-after. Respons menyertakan header anthropic-ratelimit-requests-* untuk batas yang berlaku (pada validasi marketplace, batas 10 per menitnya; pada 429, batas mana pun yang menolak permintaan).

Unggahan, perubahan versi yang disajikan, atau validasi juga dapat mengembalikan 429 dengan retry-after ketika layanan untuk sementara tidak memiliki kapasitas untuk permintaan lain, dan unggahan mengembalikan 429 ketika organisasi Anda telah melampaui laju pemindaian kontennya. Tangani semua kasus ini dengan cara yang sama: tunggu sesuai retry-after, lalu coba lagi. Terpisah dari batas-batas ini, kirim penulisan pengaturan instalasi untuk plugin yang sama satu per satu: ketika beberapa tiba bersamaan, sebagian dapat dijawab dengan 503 dan x-should-retry: true, dan permintaan tersebut aman untuk dikirim lagi setelah satu atau dua detik (lihat Menetapkan pengaturan instalasi).

Paginasi

Endpoint daftar menggunakan cursor buram ("opaque cursor"). Permintaan pertama mengembalikan hingga limit baris ditambah cursor next_page; berikan cursor tersebut tanpa perubahan sebagai parameter page pada permintaan berikutnya, dan ulangi hingga next_page bernilai null. Perlakukan string cursor sebagai buram: jangan mengurai, mengubah, atau menyusunnya sendiri. Mencantumkan plugin dapat mengembalikan halaman dengan plugin kurang dari limit, atau tanpa plugin sama sekali, sementara next_page masih terisi, jadi teruslah meminta halaman hingga next_page bernilai null. Iterator daftar pada SDK mengambil halaman berikutnya saat Anda melakukan iterasi tetapi berhenti pada halaman kosong pertama, sehingga pada daftar plugin iterator tersebut dapat berhenti lebih awal; ketika Anda memerlukan setiap plugin, seperti pada alur kerja inventaris keamanan, minta setiap halaman sendiri dan berikan next_page-nya sebagai page.

limit memiliki default 20 dan minimum 1. Maksimumnya adalah 100 untuk plugin, pengaturan instalasi, dan pembagian, serta 1.000 untuk versi dan marketplace. Setiap daftar diurutkan dari yang terbaru.

Respons error

Respons error mengikuti bentuk standar yang didokumentasikan di Error. Sertakan request_id dari body respons saat menghubungi dukungan.

Ketika satu status memiliki beberapa penyebab yang perlu Anda tangani secara berbeda, error juga menyertakan error.details.error_code, serta error.details.plugin_id atau error.details.plugin_version_id ketika penyebabnya melibatkan salah satunya:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "...",
    "details": {
      "error_code": "plugin_name_taken",
      "plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
    }
  },
  "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}

Kode baru dapat ditambahkan. Perlakukan kode yang tidak Anda kenali sebagaimana Anda memperlakukan statusnya.

Mencoba ulang unggahan

Tidak ada endpoint yang menerima Idempotency-Key. Mengubah versi yang disajikan, menetapkan pengaturan instalasi, dan menetapkan default marketplace aman untuk diulang. Penghapusan yang diulang, atau penghapusan pengaturan instalasi grup yang diulang, mengembalikan 404.

Unggahan yang mengembalikan error tidak menyimpan apa pun, dengan satu pengecualian: 503 dengan error_code: "registration_pending". Setelah menyimpan file unggahan, server mendaftarkan skill versi baru ke claude.ai, yang membuat skill tersebut dapat digunakan oleh anggota; registration_pending berarti file telah disimpan tetapi langkah terakhir tersebut tidak selesai. Mengunggah file yang sama sekali lagi akan menyelesaikannya (dan menyimpan satu versi lagi yang identik):

• Pada POST /v1/organizations/plugins, plugin telah dibuat, dan respons menyertakan x-should-retry: false: jangan kirim ulang permintaan pembuatan (pengiriman ulang mengembalikan 409 plugin_name_taken); sebagai gantinya, unggah file yang sama sebagai versi dari details.plugin_id.
• Pada POST /v1/organizations/plugins/{plugin_id}/versions, versi telah disimpan (details.plugin_version_id); kirim ulang permintaan yang sama ketika respons menyertakan x-should-retry: true, dan jangan lakukan ketika respons menyertakan false.

Jika respons pembuatan hilang, coba lagi: percobaan ulang mengembalikan 409 plugin_name_taken dengan ID plugin di details.plugin_id, dan Anda melanjutkan dengan plugin tersebut. Mencoba ulang pembuatan versi yang responsnya hilang akan menyimpan versi kedua yang identik. Untuk menghindarinya, catat latest_version_id plugin sebelum setiap unggahan; jika respons hilang, baca plugin tersebut dan coba lagi hanya jika latest_version_id tidak berubah.

Event Activity Feed

Setiap penulisan melalui API ini dicatat di Compliance API Activity Feed organisasi Anda, diatribusikan ke kunci API sebagai api_actor yang membawa ID apikey_-nya. Aktor yang sama muncul di created_by pada plugin dan versi yang dibuat oleh kunci tersebut.

ID plugin, versi, dan marketplace dalam event ini adalah ID yang sama dengan yang dikembalikan API ini. plugin_installation_preference_updated mengidentifikasi plugin berdasarkan name dan marketplace_id-nya, bukan id-nya.

Mengubah default marketplace mencatat satu event marketplace_updated dan tidak ada event per plugin, meskipun perubahan tersebut mengubah nilai setiap plugin yang mewarisi default tersebut. Pembacaan tidak dicatat, kecuali unduhan arsip plugin milik anggota. Penulisan yang tidak mengubah apa pun tidak mencatat apa pun.

Pembagian yang diberikan atau ditarik di claude.ai muncul di feed sebagai event role_assignment_granted dan role_assignment_revoked. API ini tidak melaporkan penghapusan: plugin yang dihapus hanya tidak muncul di daftar berikutnya. Plugin yang dihapus melalui sinkronisasi Git, melalui penghapusan marketplace-nya (satu event marketplace_deleted), atau melalui penghapusan akun anggota atau organisasi tidak memancarkan event per plugin, jadi tampilkan ulang daftar inventaris lengkap secara berkala untuk mendeteksi penghapusan.

Kunci enkripsi yang dikelola pelanggan

Jika organisasi Anda menggunakan kunci enkripsi yang dikelola pelanggan, description, release_notes, components, dan file suatu versi dienkripsi dengan kunci tersebut. Selama kunci tidak tersedia:

• Pembacaan dan daftar tetap berhasil, dengan description, release_notes, dan components dikembalikan sebagai null.
• Unduhan arsip, pembuatan, pembuatan versi, dan perubahan versi yang disajikan mengembalikan 400 dengan cmek_key_disabled atau cmek_key_network_blocked.
• Menghapus plugin di marketplace pustaka mengembalikan 400 cmek_key_disabled dan tidak menghapus apa pun, karena skill-nya harus terlebih dahulu ditarik dari claude.ai dan hal itu memerlukan kunci tersebut. Penghapusan lainnya, pengaturan instalasi, dan default marketplace berfungsi seperti biasa.

Memulihkan kunci akan menghilangkan semua kondisi ini.

Lihat juga