Crea versione del Plugin
Aggiungi una versione a un Plugin di proprietà dell'organizzazione caricando i file della nuova versione; diventa la versione servita ai membri a meno che la versione servita del Plugin non sia stata fissata.
Il caricamento usa lo stesso multipart/form-data della creazione di un Plugin: i file della versione (files, con ogni parte inviata come files[]) e release_notes facoltativo. Il name del manifest caricato deve essere uguale al name del Plugin. Restituisce la versione archiviata; rileggi il Plugin per vedere quale versione serve.
Solo un Plugin in un marketplace manual accetta caricamenti; un Plugin sincronizzato da un repository ottiene le sue versioni dal repository. Quando il Plugin si trova nel marketplace della libreria dell'organizzazione, una versione che aggiunge una skill con il nome di una skill dell'organizzazione (una skill che un amministratore ha caricato per l'intera organizzazione in claude.ai) viene rifiutata con un 409: error_code skill_name_taken, con quel nome in details.skill_name. Un 503 con error_code registration_pending significa che la versione è stata archiviata ma non è ancora utilizzabile; una successiva creazione di versione sul Plugin la completa.
Per un esempio pratico, consulta Creare una versione nella guida alla Plugins API.
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_version = client.beta.organization.plugins.versions.create(
plugin_id="plugin_id",
files=[b"Example data"],
)
print(beta_plugin_version.id){
"id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
"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",
"manifest_version": "1.2.0",
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"reach": "contained",
"release_notes": "Adds a review checklist for database migrations.",
"type": "plugin_version"
}Returns Examples
{
"id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
"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",
"manifest_version": "1.2.0",
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"reach": "contained",
"release_notes": "Adds a review checklist for database migrations.",
"type": "plugin_version"
}