Claude Platform Docs

플러그인

플러그인 생성
beta.organization.plugins.create(**kwargs) -> BetaPlugin
POST/v1/organizations/plugins

버전의 파일을 업로드하여 조직 소유 플러그인과 그 첫 번째 버전을 생성합니다.

플러그인 조회
beta.organization.plugins.retrieve(plugin_id, **kwargs) -> BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

ID로 플러그인을 조회합니다.

플러그인 업데이트
beta.organization.plugins.update(plugin_id, **kwargs) -> BetaPlugin
POST/v1/organizations/plugins/{plugin_id}

조직 소유 플러그인의 저장된 버전 중 구성원에게 제공할 버전을 변경합니다. 예를 들어 이전 버전으로 롤백할 때 사용합니다. 이 작업은 제공되는 버전을 고정(pin)합니다. 이후 업로드되는 버전은 저장되지만 더 이상 제공되는 버전을 변경하지 않으며, 고정은 현재 여기서나 claude.ai에서 취소할 수 없습니다.

플러그인 목록 조회
beta.organization.plugins.list(**kwargs) -> PageCursor<BetaPlugin>
GET/v1/organizations/plugins

조직에서 생성된 플러그인을 최신순으로 나열합니다. 조직 자체의 플러그인 마켓플레이스에 있는 플러그인과 구성원의 개인 플러그인 마켓플레이스에 있는 플러그인이 모두 포함됩니다.

플러그인 삭제
beta.organization.plugins.delete(plugin_id, **kwargs) -> BetaDeletedPlugin
DELETE/v1/organizations/plugins/{plugin_id}

관리자가 claude.ai에서 삭제할 때와 똑같이 플러그인과 그 플러그인이 보유한 모든 버전을 영구적으로 삭제합니다. 플러그인은 조직 소유일 수도 있고, 이후 조직을 떠난 구성원을 포함한 구성원 소유일 수도 있습니다.

Models
class BetaDeletedPlugin { type: :plugin_deleted, id }
type: :plugin_deleted

Always plugin_deleted.

id: String

The deleted Plugin's ID.

class BetaPlugin { type: :plugin, id, components, 16 more }
class BetaPluginAPIActor { type: :api_actor, api_key_id }
type: :api_actor

An Admin API key, in the same form the Compliance API activity feed uses for it.

api_key_id: String

The key's ID.

class BetaPluginComponent { type, description, name }
type: :agent | :cli | :command | 3 more

The kind of component.

One of the following:
:agent
:cli
:command
:hook
:mcp_server
:skill
description: String

What the component declares about itself; always null for MCP servers, hooks, and CLIs.

name: String

The component's name: a skill's, command's or agent's name, an MCP server's key in the manifest, the event a hook runs on, or a CLI's executable.

class BetaPluginContentScan { assessment, reason, status }
assessment: :fail | :pass | :unknown | :warn

The scan's verdict; set only when status is completed.

One of the following:
:fail
:pass
:unknown
:warn
reason: String

The primary mechanism behind a warn or fail, such as credential-exposure or guardrail-tampering; a mechanism this API does not yet name reads as other. Null on a pass, whenever assessment is null, and when no mechanism is reported for the verdict.

status: :completed | :errored | :processing

processing while a scan runs, completed when it ran to completion, errored when it could not run or its outcome cannot be read.

One of the following:
:completed
:errored
:processing
class BetaPluginOwnerOrganization { type: :organization }
type: :organization

The Plugin lives in a plugin marketplace the organization owns.

class BetaPluginOwnerUser { type: :user, user_id }
type: :user

The Plugin lives in one member's personal plugin marketplace.

user_id: String

The member's User ID.

class BetaPluginTargetOrganization { type: :organization }
type: :organization

Every member of the organization.

class BetaPluginTargetOrganizationMember { type: :organization_member, user_id }
type: :organization_member

One member of the organization.

user_id: String

The member's User ID.

class BetaPluginTargetRBACGroup { type: :rbac_group, rbac_group_id }
type: :rbac_group

An RBAC Group.

rbac_group_id: String

The RBAC Group's ID.

class BetaPluginUserActor { type: :user_actor, email_address, user_id }
type: :user_actor

A member of the organization.

email_address: String

The member's email address; may be null, for example when they are no longer a member of the organization.

user_id: String

The member's User ID.

플러그인버전

플러그인 버전 생성
beta.organization.plugins.versions.create(plugin_id, **kwargs) -> BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

새 버전의 파일을 업로드하여 조직 소유 플러그인에 버전을 추가합니다. 플러그인의 제공 버전이 고정되지 않은 한, 추가된 버전이 구성원에게 제공되는 버전이 됩니다.

플러그인 버전 목록 조회
beta.organization.plugins.versions.list(plugin_id, **kwargs) -> PageCursor<BetaPluginVersion>
GET/v1/organizations/plugins/{plugin_id}/versions

플러그인의 버전을 최신순으로 나열합니다.

플러그인 버전 조회
beta.organization.plugins.versions.retrieve(version, **kwargs) -> BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

ID로 플러그인의 특정 버전을 조회하거나 플러그인의 최신 버전을 조회합니다.

플러그인 버전 아카이브 다운로드
beta.organization.plugins.versions.download(version, **kwargs) -> StringIO
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

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

플러그인설치 설정

플러그인 설치 설정 목록 조회
beta.organization.plugins.installation_settings.list(plugin_id, **kwargs) -> PageCursor<BetaPluginInstallationSetting>
GET/v1/organizations/plugins/{plugin_id}/installation_settings

조직 소유 플러그인의 설치 설정을 가장 최근에 생성된 순서로 나열합니다. 설치 설정은 플러그인이 어떤 구성원을 위한 것인지를 나타냅니다.

플러그인 설치 설정 지정
beta.organization.plugins.installation_settings.set(target, **kwargs) -> BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

조직 전체 또는 하나의 RBAC 그룹에 대한 조직 소유 플러그인의 설치 설정을 지정하거나 변경합니다.

플러그인 설치 설정 제거
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

조직 전체 또는 하나의 RBAC 그룹에 대한 조직 소유 플러그인 자체의 설치 설정을 제거합니다.

플러그인공유

플러그인 공유 목록 조회
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares

구성원 소유 플러그인의 소유자가 조직의 모든 구성원, RBAC 그룹 또는 한 명의 구성원에게 부여한 공유를 가장 최근에 부여된 순서로 나열합니다.