Plugin aktualisieren
Ändere, welche gespeicherte Version eines organisationseigenen Plugins an Mitglieder ausgeliefert wird, zum Beispiel um zu einer früheren zurückzukehren. Dadurch wird die ausgelieferte Version fixiert: Spätere Uploads werden gespeichert, ändern aber nicht mehr, was ausgeliefert wird, und die Fixierung kann derzeit nicht rückgängig gemacht werden, weder hier noch in claude.ai.
Übergib die Version als served_version_id: eine frühere, um zurückzurollen, eine spätere, um
eine Version auszuliefern, die gespeichert, aber nicht ausgeliefert wurde, oder die bereits
ausgelieferte, um sie zu fixieren, ohne zu ändern, was ausgeliefert wird. Es wird keine neue Version erstellt.
Wenn in der Organisation das Scannen von Inhalten aktiviert ist, wird eine Version, deren Scan noch
läuft, mit 409 abgelehnt (error_code scan_pending; versuche es erneut, sobald der Scan
abgeschlossen ist), und eine, deren Scan fehlgeschlagen ist, einen Fehler ergab oder zu keinem Ergebnis kam, mit 400
(scan_failed; ein warn wird akzeptiert). Wenn sich das Plugin im Library-Marketplace der
Organisation befindet, wird eine andere als die ausgelieferte Version ebenfalls mit 409 abgelehnt,
wenn einer ihrer Skills einen Namen hat, den inzwischen ein Organisations-Skill (einer, den ein Administrator
für die gesamte Organisation in claude.ai hochgeladen hat) belegt: error_code
skill_name_taken, mit diesem Namen in details.skill_name. Ein mitgliedseigenes Plugin
kann hier nicht aktualisiert werden (403).
Dieser Endpunkt schreibt keine Installationseinstellungen; diese werden unter
/v1/organizations/plugins/{plugin_id}/installation_settings/{target} geschrieben.
Akzeptierte Anmeldedaten: ein Admin-API-Key mit dem Scope write:plugins.
Jede Anfrage muss den Beta-Header anthropic-beta: ce-plugins-2026-09-01 enthalten. Eine Anfrage ohne ihn gibt 404 zurück, genau so, als ob der Endpunkt nicht existieren würde. Die Plugins API befindet sich in der Beta und ist nur für Claude Enterprise-Organisationen verfügbar. Sie ist nicht für Claude Platform (Claude Console)-Organisationen oder für Organisationen mit aktivierter HIPAA-Readiness verfügbar.
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"
}