플러그인 버전 생성
새 버전의 파일을 업로드하여 조직 소유 플러그인에 버전을 추가합니다. 플러그인의 제공 버전이 고정되지 않은 한, 추가된 버전이 구성원에게 제공되는 버전이 됩니다.
업로드는 플러그인 생성과 동일한 multipart/form-data 형식입니다. 버전의 파일(files, 각 파트는 files[]로 전송)과 선택 사항인 release_notes를 포함합니다. 업로드된 매니페스트의 name은 플러그인의 name과 같아야 합니다. 저장된 버전을 반환합니다. 플러그인이 어떤 버전을 제공하는지 확인하려면 플러그인을 다시 조회하세요.
manual 마켓플레이스에 있는 플러그인만 업로드를 받습니다. 리포지토리에서 동기화된 플러그인은 리포지토리에서 버전을 가져옵니다. 플러그인이 조직의 라이브러리 마켓플레이스에 있는 경우, 조직 스킬(관리자가 claude.ai에서 조직 전체를 위해 업로드한 스킬)과 같은 이름의 스킬을 추가하는 버전은 409로 거부됩니다. 이때 error_code는 skill_name_taken이며 해당 이름은 details.skill_name에 포함됩니다. error_code가 registration_pending인 503은 버전이 저장되었지만 아직 사용할 수 없음을 의미합니다. 이후 해당 플러그인에서 버전을 생성하면 등록이 완료됩니다.
실제 예시는 Plugins API 가이드의 버전 생성을 참조하세요.
허용되는 자격 증명: 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_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"
}