Plugin-Installationseinstellung festlegen
Legt die Installationseinstellung eines organisationseigenen Plugins für die gesamte Organisation oder für eine RBAC-Gruppe fest oder ändert sie.
Das Schreiben des Werts, den ein Ziel bereits selbst hat, ändert nichts.
Ein mitgliedseigenes Plugin hat statt Installationseinstellungen Freigaben, daher gibt dieser Pfad dafür 404 zurück.
Sende die Schreibvorgänge für die Installationseinstellungen eines Plugins einzeln nacheinander. Wenn mehrere Schreibvorgänge für
dasselbe Plugin gleichzeitig eintreffen, verarbeitet der Server sie nacheinander und
kann einige davon mit 503 beantworten, statt sie anzuwenden. Diese 503 enthält
x-should-retry: true, und der Schreibvorgang kann gefahrlos wiederholt werden: Warte ein oder zwei Sekunden und
sende ihn dann erneut.
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_installation_setting = (
client.beta.organization.plugins.installation_settings.set(
target="target",
plugin_id="plugin_id",
installation_preference="required",
)
)
print(beta_plugin_installation_setting.plugin_id){
"created_at": "2026-03-14T09:26:53.589793Z",
"installation_preference": "required",
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"target": {
"type": "organization"
},
"type": "plugin_installation_setting",
"updated_at": "2026-03-14T09:26:53.589793Z"
}Returns Examples
{
"created_at": "2026-03-14T09:26:53.589793Z",
"installation_preference": "required",
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"target": {
"type": "organization"
},
"type": "plugin_installation_setting",
"updated_at": "2026-03-14T09:26:53.589793Z"
}