Mettre à jour un plugin
Modifiez la version stockée d'un Plugin appartenant à l'organisation qui est servie aux membres, par exemple pour revenir à une version antérieure. Cela épingle la version servie : les téléversements ultérieurs sont stockés mais ne modifient plus ce qui est servi, et l'épinglage ne peut actuellement pas être annulé, ni ici ni dans claude.ai.
Transmettez la version dans served_version_id : une version antérieure pour revenir en arrière, une version ultérieure pour commencer à servir une version stockée sans avoir été servie, ou celle déjà servie pour l'épingler sans modifier ce qui est servi. Aucune nouvelle version n'est créée.
Lorsque l'analyse de contenu est activée pour l'organisation, une version dont l'analyse est encore en cours est refusée avec une erreur 409 (error_code scan_pending ; réessayez une fois l'analyse terminée) et une version dont l'analyse a échoué, a rencontré une erreur ou n'a abouti à aucun verdict est refusée avec une erreur 400 (scan_failed ; un warn est accepté). Lorsque le Plugin se trouve dans la marketplace de bibliothèque de l'organisation, une version autre que celle servie est également refusée avec une erreur 409 si l'une de ses skills porte un nom qui a depuis été pris par une skill d'organisation (une skill qu'un administrateur a téléversée pour toute l'organisation dans claude.ai) : error_code skill_name_taken, avec ce nom dans details.skill_name. Un Plugin appartenant à un membre ne peut pas être mis à jour ici (403).
Ce point de terminaison n'écrit pas les paramètres d'installation ; ceux-ci sont écrits à /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.
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 = 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"
}