Aggiorna plugin
Cambia quale versione archiviata di un Plugin di proprietà dell'organizzazione viene servita ai membri, ad esempio per tornare a una versione precedente. Questa operazione fissa la versione servita: i caricamenti successivi vengono archiviati ma non cambiano più ciò che viene servito, e al momento il fissaggio non può essere annullato, né qui né in claude.ai.
Passa la versione come served_version_id: una precedente per tornare indietro, una successiva per iniziare a servire una versione archiviata senza essere servita, oppure quella già servita per fissarla senza cambiare ciò che viene servito. Non viene creata alcuna nuova versione.
Quando l'organizzazione ha la scansione dei contenuti abilitata, una versione la cui scansione è ancora in corso viene rifiutata con un 409 (error_code scan_pending; riprova al termine della scansione) e una la cui scansione non è riuscita, ha generato un errore o non ha raggiunto un verdetto viene rifiutata con un 400 (scan_failed; un warn è accettato). Quando il Plugin si trova nel marketplace della libreria dell'organizzazione, una versione diversa da quella servita viene rifiutata anche con un 409 quando una delle sue skill ha un nome che nel frattempo è stato preso da una skill dell'organizzazione (una skill che un amministratore ha caricato per l'intera organizzazione in claude.ai): error_code skill_name_taken, con quel nome in details.skill_name. Un Plugin di proprietà di un membro non può essere aggiornato qui (403).
Questo endpoint non scrive le impostazioni di installazione; queste vengono scritte in /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.
Credenziali accettate: una chiave API Admin con lo scope write:plugins.
Ogni richiesta deve includere l'header beta anthropic-beta: ce-plugins-2026-09-01. Una richiesta senza di esso restituisce 404, esattamente come se l'endpoint non esistesse. La Plugins API è in beta ed è disponibile solo per le organizzazioni Claude Enterprise. Non è disponibile per le organizzazioni Claude Platform (Claude Console), né per le organizzazioni con la predisposizione HIPAA abilitata.
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 = client.beta.organization.plugins.update(
plugin_id="plugin_id",
served_version_id="pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
)
print(beta_plugin.id){
"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"
}