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
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.organization.plugins.installationsettings.BetaPluginInstallationSetting;
import com.anthropic.models.beta.organization.plugins.installationsettings.InstallationSettingSetParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
InstallationSettingSetParams params = InstallationSettingSetParams.builder()
.pluginId("plugin_id")
.target("target")
.installationPreference(InstallationSettingSetParams.InstallationPreference.REQUIRED)
.build();
BetaPluginInstallationSetting betaPluginInstallationSetting = client.beta().organization().plugins().installationSettings().set(params);
}
}{
"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"
}