プラグインの更新
組織所有のプラグインについて、保存されているどのバージョンをメンバーに提供するかを変更します。たとえば、以前のバージョンにロールバックする場合に使用します。これにより提供バージョンが固定されます。以降のアップロードは保存されますが、提供内容は変わらなくなります。また、固定は現在、ここでもclaude.aiでも元に戻すことができません。
バージョンを served_version_id として渡します。ロールバックするには以前のバージョンを、提供されずに保存されたバージョンの提供を開始するには後のバージョンを、提供内容を変えずに固定するには現在提供中のバージョンを指定します。新しいバージョンは作成されません。
組織でコンテンツスキャンが有効になっている場合、スキャンがまだ実行中のバージョンは409で拒否され(error_code scan_pending。スキャン完了後に再試行してください)、スキャンが失敗した、エラーになった、または判定に至らなかったバージョンは400で拒否されます(scan_failed。warn は受け入れられます)。プラグインが組織のライブラリマーケットプレイスにある場合、現在提供中のもの以外のバージョンで、そのスキルのいずれかの名前がその後に組織スキル(管理者がclaude.aiで組織全体向けにアップロードしたスキル)によって使用されている場合も409で拒否されます。error_code は skill_name_taken で、その名前は details.skill_name に含まれます。メンバー所有のプラグインはここでは更新できません(403)。
このエンドポイントはインストール設定を書き込みません。インストール設定は /v1/organizations/plugins/{plugin_id}/installation_settings/{target} で書き込みます。
受け入れられる認証情報: write:plugins スコープを持つAdmin APIキー。
すべてのリクエストにベータヘッダー anthropic-beta: ce-plugins-2026-09-01 を含める必要があります。含まれていないリクエストは、エンドポイントが存在しない場合とまったく同じく 404 を返します。Plugins APIはベータ版であり、Claude Enterprise組織のみが利用できます。Claude Platform(Claude Console)組織、または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"
}