Claude Platform Docs

플러그인 버전 아카이브 다운로드

beta.organization.plugins.versions.download(version, **kwargs) -> BinaryResponseContent
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

특정 버전의 .zip 아카이브를 저장된 그대로 다운로드합니다. 구성원의 개인 플러그인 마켓플레이스에 있는 플러그인을 다운로드할 때마다 Compliance API 활동 피드에 기록됩니다.

응답 본문은 아카이브(Content-Type: application/zip)이며, 플러그인 이름에서 파생된 파일 이름의 첨부 파일로 전송됩니다. 이 파일 이름은 고유하지 않으므로 저장하는 파일의 이름은 요청 경로의 ID를 사용해 지정하세요.

허용되는 자격 증명: read:plugins 또는 read:org_audit 범위가 있는 Admin API 키, 또는 read:compliance_org_data 범위가 있는 Compliance Access Key.

위의 모든 읽기 범위(read:plugins, read:org_audit, read:compliance_org_data)는 claude.ai의 관리자 설정에 표시되지 않는 파일을 포함하여 구성원의 개인 마켓플레이스에 있는 플러그인의 파일을 다운로드할 수 있습니다. 또한 상위 조직에 연결된 모든 조직을 대상으로 생성된 read:org_audit 또는 read:compliance_org_data 키는 organization_id를 전달하여 그 아래에서 이 API에 액세스할 수 있는 모든 조직에서 이 작업을 수행할 수 있습니다. 이러한 다운로드는 각각 Compliance API 활동 피드에 키, 플러그인, 버전, 구성원을 식별하는 claude_plugin_archive_accessed 이벤트를 기록합니다. 조직 소유 플러그인의 다운로드는 기록되지 않습니다.

모든 요청에는 베타 헤더 anthropic-beta: ce-plugins-2026-09-01을 포함해야 합니다. 이 헤더가 없는 요청은 엔드포인트가 존재하지 않는 것과 똑같이 404를 반환합니다. Plugins API는 베타 버전이며 Claude Enterprise 조직에서만 사용할 수 있습니다. Claude Platform(Claude Console) 조직이나 HIPAA 준비가 활성화된 조직에서는 사용할 수 없습니다.

Parameters
plugin_id: str⁠Path parameter

ID of the Plugin (prefixed plugin_).

version: str⁠Path parameter

ID of the Plugin Version (prefixed pluginver_). latest is not accepted here.

organization_id: Optional[str]⁠Query parameter

For a read:org_audit or read:compliance_org_data key created for all of a parent organization's linked organizations: a child organization of that parent to read instead of the organization the key was created in, given as the organization's UUID or its org_-prefixed ID. A value that is neither returns a 400; an organization that is not a child of the key's parent, or where the Plugins API is not available, returns a 404. Any other key may pass only its own organization's ID here; another organization returns a 404.

betas: Optional[List[AnthropicBetaParam]]⁠Header parameter

This endpoint is in beta: requests must send ce-plugins-2026-09-01 in this header.

One of the following:
str
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
Returns
BinaryResponseContent
플러그인 버전 아카이브 다운로드
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
response = client.beta.organization.plugins.versions.download(
    version="version",
    plugin_id="plugin_id",
)
print(response)
content = response.read()
print(content)