Definir configuração de instalação do Plugin
Defina ou altere a configuração de instalação de um Plugin pertencente à organização para toda a organização ou para um Grupo RBAC.
Gravar o valor que um destino já possui como próprio não altera nada.
Um Plugin pertencente a um membro tem compartilhamentos em vez de configurações de instalação, então este caminho retorna 404 para ele.
Envie as gravações de configuração de instalação de um Plugin uma de cada vez. Se várias gravações para o mesmo Plugin chegarem ao mesmo tempo, o servidor as processa uma após a outra e pode responder a algumas delas com 503 em vez de aplicá-las. Esse 503 inclui x-should-retry: true, e a gravação pode ser repetida com segurança: aguarde um ou dois segundos e envie-a novamente.
Credenciais aceitas: uma chave de API de Admin com o escopo write:plugins.
Toda solicitação deve incluir o cabeçalho beta anthropic-beta: ce-plugins-2026-09-01. Uma solicitação sem ele retorna 404, exatamente como se o endpoint não existisse. A API de Plugins está em beta e está disponível apenas para organizações Claude Enterprise. Ela não está disponível para organizações da Claude Platform (Claude Console) nem para organizações com prontidão para HIPAA habilitada.
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"
}