Créer une version de Plugin
Ajoutez une version à un Plugin appartenant à l'organisation en téléversant les fichiers de la nouvelle version ; elle devient la version servie aux membres, sauf si la version servie du Plugin a été épinglée.
Le téléversement utilise le même format multipart/form-data que la création d'un Plugin : les fichiers de la version (files, chaque partie étant envoyée sous la forme files[]) et un champ facultatif release_notes. Le name du manifeste téléversé doit être identique au name du Plugin. Renvoie la version stockée ; relisez le Plugin pour savoir quelle version il sert.
Seul un Plugin d'une marketplace manual accepte les téléversements ; un Plugin synchronisé depuis un dépôt obtient ses versions depuis le dépôt. Lorsque le Plugin se trouve dans la marketplace de bibliothèque de l'organisation, une version qui ajoute une skill portant le nom d'une skill d'organisation (une skill qu'un administrateur a téléversée pour toute l'organisation dans claude.ai) est refusée avec une erreur 409 : error_code skill_name_taken, avec ce nom dans details.skill_name. Une erreur 503 avec error_code registration_pending signifie que la version a été stockée mais n'est pas encore utilisable ; une création de version ultérieure sur le Plugin la finalise.
Pour un exemple détaillé, consultez Créer une version dans le guide de l'API Plugins.
Identifiants acceptés : une clé API Admin avec la portée write:plugins.
Chaque requête doit inclure l'en-tête bêta anthropic-beta: ce-plugins-2026-09-01. Une requête sans cet en-tête renvoie 404, exactement comme si le point de terminaison n'existait pas. L'API Plugins est en bêta et n'est disponible que pour les organisations Claude Enterprise. Elle n'est pas disponible pour les organisations Claude Platform (Claude Console), ni pour les organisations pour lesquelles la conformité HIPAA est activée.
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"
}