Обновление плагина
Изменяет, какая из сохранённых версий плагина, принадлежащего организации, предоставляется участникам, — например, чтобы откатиться к более ранней. Это закрепляет предоставляемую версию: последующие загрузки сохраняются, но больше не меняют предоставляемую версию, а закрепление в настоящее время нельзя отменить ни здесь, ни в claude.ai.
Передайте версию в served_version_id: более раннюю — чтобы откатиться, более позднюю — чтобы начать предоставлять версию, которая была сохранена без предоставления, или уже предоставляемую — чтобы закрепить её, не меняя предоставляемую версию. Новая версия не создаётся.
Если в организации включено сканирование содержимого, версия, сканирование которой ещё выполняется, отклоняется с кодом 409 (error_code scan_pending; повторите попытку после завершения сканирования), а версия, сканирование которой завершилось неудачей, ошибкой или без вердикта, — с кодом 400 (scan_failed; результат warn принимается). Если плагин находится в библиотечном маркетплейсе организации, версия, отличная от предоставляемой, также отклоняется с кодом 409, если один из её навыков имеет имя, которое с тех пор занял навык организации (навык, загруженный администратором для всей организации в claude.ai): error_code skill_name_taken, а это имя указывается в details.skill_name. Плагин, принадлежащий участнику, здесь обновить нельзя (403).
Эта конечная точка не записывает параметры установки; они записываются через /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.
Принимаемые учётные данные: ключ Admin API с областью write:plugins.
Каждый запрос должен содержать бета-заголовок anthropic-beta: ce-plugins-2026-09-01. Запрос без него возвращает 404 — точно так же, как если бы конечной точки не существовало. Plugins API находится в стадии бета-тестирования и доступен только организациям Claude Enterprise. Он недоступен организациям Claude Platform (Claude Console), а также организациям с включённой готовностью к HIPAA.
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"
}