플러그인 업데이트
조직 소유 플러그인의 저장된 버전 중 구성원에게 제공할 버전을 변경합니다. 예를 들어 이전 버전으로 롤백할 때 사용합니다. 이 작업은 제공되는 버전을 고정(pin)합니다. 이후 업로드되는 버전은 저장되지만 더 이상 제공되는 버전을 변경하지 않으며, 고정은 현재 여기서나 claude.ai에서 취소할 수 없습니다.
버전을 served_version_id로 전달하세요. 롤백하려면 이전 버전을, 저장만 되고 제공되지 않은 버전의 제공을 시작하려면 이후 버전을, 제공되는 버전을 변경하지 않고 고정만 하려면 이미 제공 중인 버전을 전달합니다. 새 버전은 생성되지 않습니다.
조직에서 콘텐츠 스캔이 활성화된 경우, 스캔이 아직 진행 중인 버전은 409로 거부되고(error_code scan_pending, 스캔이 완료된 후 다시 시도하세요), 스캔이 실패했거나 오류가 발생했거나 판정에 도달하지 못한 버전은 400으로 거부됩니다(scan_failed, warn은 허용됨). 플러그인이 조직의 라이브러리 마켓플레이스에 있는 경우, 현재 제공 중인 버전이 아닌 버전에 포함된 스킬의 이름을 그 이후 조직 스킬(관리자가 claude.ai에서 조직 전체를 위해 업로드한 스킬)이 사용하게 되었다면 해당 버전도 409로 거부됩니다. 이때 error_code는 skill_name_taken이며 해당 이름은 details.skill_name에 포함됩니다. 구성원 소유 플러그인은 여기서 업데이트할 수 없습니다(403).
이 엔드포인트는 설치 설정을 기록하지 않습니다. 설치 설정은 /v1/organizations/plugins/{plugin_id}/installation_settings/{target}에서 기록됩니다.
허용되는 자격 증명: write:plugins 범위가 있는 Admin API 키.
모든 요청에는 베타 헤더 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"
}