Memperbarui Plugin
Ubah versi tersimpan mana dari Plugin milik organisasi yang disajikan kepada anggota, misalnya untuk melakukan rollback ke versi sebelumnya. Tindakan ini menyematkan (pin) versi yang disajikan: unggahan berikutnya tetap disimpan tetapi tidak lagi mengubah apa yang disajikan, dan penyematan saat ini tidak dapat dibatalkan, baik di sini maupun di claude.ai.
Teruskan versi tersebut sebagai served_version_id: versi sebelumnya untuk melakukan rollback, versi yang lebih baru untuk mulai menyajikan versi yang disimpan tanpa disajikan, atau versi yang sudah disajikan untuk menyematkannya tanpa mengubah apa yang disajikan. Tidak ada versi baru yang dibuat.
Jika organisasi mengaktifkan pemindaian konten, versi yang pemindaiannya masih berjalan ditolak dengan 409 (error_code scan_pending; coba lagi setelah pemindaian selesai) dan versi yang pemindaiannya gagal, mengalami error, atau tidak menghasilkan putusan ditolak dengan 400 (scan_failed; warn diterima). Jika Plugin berada di marketplace pustaka organisasi, versi selain yang sedang disajikan juga ditolak dengan 409 apabila salah satu skill-nya memiliki nama yang sejak itu telah dipakai oleh skill organisasi (skill yang diunggah administrator untuk seluruh organisasi di claude.ai): error_code skill_name_taken, dengan nama tersebut di details.skill_name. Plugin milik anggota tidak dapat diperbarui di sini (403).
Endpoint ini tidak menulis pengaturan instalasi; pengaturan tersebut ditulis di /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.
Kredensial yang diterima: kunci API Admin dengan scope write:plugins.
Setiap permintaan harus menyertakan header beta anthropic-beta: ce-plugins-2026-09-01. Permintaan tanpa header tersebut mengembalikan 404, persis seolah-olah endpoint tidak ada. Plugins API masih dalam tahap beta dan hanya tersedia untuk organisasi Claude Enterprise. API ini tidak tersedia untuk organisasi Claude Platform (Claude Console), atau untuk organisasi yang mengaktifkan kesiapan HIPAA.
Parameters
Returns
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get(
"ANTHROPIC_API_KEY"
), # This is the default and can be omitted
)
beta_plugin = client.beta.organization.plugins.update(
plugin_id="plugin_id",
served_version_id="pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
)
print(beta_plugin.id){
"id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"components": [
{
"description": "description",
"name": "review-pr",
"type": "skill"
}
],
"content_scan": {
"assessment": "warn",
"reason": "credential-exposure",
"status": "completed"
},
"created_at": "2026-03-14T09:26:53.589793Z",
"created_by": {
"email_address": "user@example.com",
"type": "user_actor",
"user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
},
"description": "Reviews pull requests against your team's conventions.",
"display_name": "Code Review Helper",
"latest_version_id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
"manifest_version": "1.2.0",
"marketplace_id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
"name": "code-review-helper",
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"owner": {
"type": "organization"
},
"reach": "contained",
"served_version_id": "pluginver_01K9wPcHd4Rm2Tx8Vq6Ln3Sb",
"served_version_pinned": true,
"type": "plugin",
"updated_at": "2026-03-14T09:26:53.589793Z"
}Returns Examples
{
"id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"components": [
{
"description": "description",
"name": "review-pr",
"type": "skill"
}
],
"content_scan": {
"assessment": "warn",
"reason": "credential-exposure",
"status": "completed"
},
"created_at": "2026-03-14T09:26:53.589793Z",
"created_by": {
"email_address": "user@example.com",
"type": "user_actor",
"user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
},
"description": "Reviews pull requests against your team's conventions.",
"display_name": "Code Review Helper",
"latest_version_id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
"manifest_version": "1.2.0",
"marketplace_id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
"name": "code-review-helper",
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"owner": {
"type": "organization"
},
"reach": "contained",
"served_version_id": "pluginver_01K9wPcHd4Rm2Tx8Vq6Ln3Sb",
"served_version_pinned": true,
"type": "plugin",
"updated_at": "2026-03-14T09:26:53.589793Z"
}