Définir un paramètre d'installation de Plugin
Définissez ou modifiez le paramètre d'installation d'un Plugin appartenant à l'organisation pour l'ensemble de l'organisation ou pour un groupe RBAC.
Écrire la valeur qu'une cible possède déjà en propre ne modifie rien.
Un Plugin appartenant à un membre possède des partages au lieu de paramètres d'installation ; ce chemin renvoie donc 404 pour un tel Plugin.
Envoyez les écritures de paramètres d'installation d'un Plugin une par une. Si plusieurs écritures pour le même Plugin arrivent en même temps, le serveur les traite l'une après l'autre et peut répondre à certaines d'entre elles par 503 au lieu de les appliquer. Cette réponse 503 comporte x-should-retry: true, et l'écriture peut être répétée sans risque : attendez une ou deux secondes, puis renvoyez-la.
Identifiants acceptés : une clé API Admin avec la portée write:plugins.
Chaque requête doit inclure l'en-tête bêta anthropic-beta: ce-plugins-2026-09-01. Une requête sans cet en-tête renvoie 404, exactement comme si le point de terminaison n'existait pas. L'API Plugins est en bêta et n'est disponible que pour les organisations Claude Enterprise. Elle n'est pas disponible pour les organisations Claude Platform (Claude Console), ni pour les organisations pour lesquelles la conformité HIPAA est activée.
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"
}