Atualizar plugin
Altere qual versão armazenada de um Plugin pertencente à organização é servida aos membros, por exemplo, para reverter para uma versão anterior. Isso fixa a versão servida: uploads posteriores são armazenados, mas deixam de alterar o que é servido, e a fixação atualmente não pode ser desfeita, nem aqui nem no claude.ai.
Passe a versão como served_version_id: uma anterior para reverter, uma posterior para começar a servir uma versão que foi armazenada sem ser servida, ou a que já está sendo servida para fixá-la sem alterar o que é servido. Nenhuma nova versão é criada.
Quando a organização tem a verificação de conteúdo habilitada, uma versão cuja verificação ainda está em andamento é recusada com um 409 (error_code scan_pending; tente novamente quando a verificação terminar) e uma cuja verificação falhou, apresentou erro ou não chegou a um veredito é recusada com um 400 (scan_failed; um warn é aceito). Quando o Plugin está no marketplace de biblioteca da organização, uma versão diferente da servida também é recusada com um 409 quando uma de suas skills tem um nome que uma skill da organização (uma que um administrador enviou para toda a organização no claude.ai) passou a usar: error_code skill_name_taken, com esse nome em details.skill_name. Um Plugin pertencente a um membro não pode ser atualizado aqui (403).
Este endpoint não grava configurações de instalação; elas são gravadas em /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.
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.BetaPlugin;
import com.anthropic.models.beta.organization.plugins.PluginUpdateParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
PluginUpdateParams params = PluginUpdateParams.builder()
.pluginId("plugin_id")
.servedVersionId("pluginver_01KaZmQpRsTuVwXyZ2b4c6d8")
.build();
BetaPlugin betaPlugin = client.beta().organization().plugins().update(params);
}
}{
"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"
}