Crear versión de Plugin
Agrega una versión a un Plugin propiedad de la organización cargando los archivos de la nueva versión; se convierte en la versión que se sirve a los miembros, a menos que la versión servida del Plugin se haya fijado.
La carga es el mismo multipart/form-data que al crear un Plugin: los archivos de la versión
(files, cada parte enviada como files[]) y release_notes opcional. El name del manifiesto cargado
debe ser igual al name del Plugin. Devuelve la versión almacenada; vuelve a leer el Plugin para
ver qué versión sirve.
Solo un Plugin de un marketplace manual acepta cargas; un Plugin sincronizado desde
un repositorio obtiene sus versiones del repositorio. Cuando el Plugin está en el
marketplace de biblioteca de la organización, una versión que agrega una skill con el nombre de una
skill de la organización (una skill que un administrador cargó para toda la organización en
claude.ai) se rechaza con un 409: error_code skill_name_taken, con ese nombre en
details.skill_name. Un 503 con error_code
registration_pending significa que la versión se almacenó, pero aún no se puede usar; una creación
de versión posterior en el Plugin la completa.
Para ver un ejemplo práctico, consulta Crear una versión en la guía de la API de Plugins.
Credenciales aceptadas: una clave de API de administrador con el alcance write:plugins.
Cada solicitud debe incluir el encabezado beta anthropic-beta: ce-plugins-2026-09-01. Una solicitud sin él devuelve 404, exactamente como si el endpoint no existiera. La API de Plugins está en beta y solo está disponible para organizaciones de Claude Enterprise. No está disponible para organizaciones de Claude Platform (Claude Console) ni para organizaciones con la preparación para HIPAA habilitada.
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"
}