Claude Platform Docs

플러그인

플러그인 생성
client.Beta.Organization.Plugins.New(ctx, params) (*BetaPlugin, error)
POST/v1/organizations/plugins

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

플러그인 조회
client.Beta.Organization.Plugins.Get(ctx, pluginID, params) (*BetaPlugin, error)
GET/v1/organizations/plugins/{plugin_id}

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

플러그인 업데이트
client.Beta.Organization.Plugins.Update(ctx, pluginID, params) (*BetaPlugin, error)
POST/v1/organizations/plugins/{plugin_id}

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

플러그인 목록 조회
client.Beta.Organization.Plugins.List(ctx, params) (*PageCursor[BetaPlugin], error)
GET/v1/organizations/plugins

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

플러그인 삭제
client.Beta.Organization.Plugins.Delete(ctx, pluginID, body) (*BetaDeletedPlugin, error)
DELETE/v1/organizations/plugins/{plugin_id}

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

Models
type BetaDeletedPlugin struct { Type: "plugin_deleted"; ID }
Type PluginDeleted

Always plugin_deleted.

defaultplugin_deleted
ID string

The deleted Plugin's ID.

type BetaPlugin struct { Type: "plugin"; ID; Components; /* 16 more */ }
type BetaPluginAPIActor struct { Type: "api_actor"; APIKeyID }
Type APIActor

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

defaultapi_actor
APIKeyID string

The key's ID.

type BetaPluginComponent struct { Type; Description; Name }
Type BetaPluginComponentType

The kind of component.

One of the following:
const BetaPluginComponentTypeAgent BetaPluginComponentType = "agent"
const BetaPluginComponentTypeCli BetaPluginComponentType = "cli"
const BetaPluginComponentTypeCommand BetaPluginComponentType = "command"
const BetaPluginComponentTypeHook BetaPluginComponentType = "hook"
const BetaPluginComponentTypeMCPServer BetaPluginComponentType = "mcp_server"
const BetaPluginComponentTypeSkill BetaPluginComponentType = "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.

type BetaPluginContentScan struct { Assessment; Reason; Status }
Assessment BetaPluginContentScanAssessment

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

One of the following:
const BetaPluginContentScanAssessmentFail BetaPluginContentScanAssessment = "fail"
const BetaPluginContentScanAssessmentPass BetaPluginContentScanAssessment = "pass"
const BetaPluginContentScanAssessmentUnknown BetaPluginContentScanAssessment = "unknown"
const BetaPluginContentScanAssessmentWarn BetaPluginContentScanAssessment = "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 BetaPluginContentScanStatus

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:
const BetaPluginContentScanStatusCompleted BetaPluginContentScanStatus = "completed"
const BetaPluginContentScanStatusErrored BetaPluginContentScanStatus = "errored"
const BetaPluginContentScanStatusProcessing BetaPluginContentScanStatus = "processing"
type BetaPluginOwnerOrganization struct { Type: "organization" }
Type Organization

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
type BetaPluginOwnerUser struct { Type: "user"; UserID }
Type User

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

defaultuser
UserID string

The member's User ID.

type BetaPluginTargetOrganization struct { Type: "organization" }
Type Organization

Every member of the organization.

defaultorganization
type BetaPluginTargetOrganizationMember struct { Type: "organization_member"; UserID }
Type OrganizationMember

One member of the organization.

defaultorganization_member
UserID string

The member's User ID.

type BetaPluginTargetRBACGroup struct { Type: "rbac_group"; RBACGroupID }
Type RBACGroup

An RBAC Group.

defaultrbac_group
RBACGroupID string

The RBAC Group's ID.

type BetaPluginUserActor struct { Type: "user_actor"; EmailAddress; UserID }
Type UserActor

A member of the organization.

defaultuser_actor
EmailAddress string

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

UserID string

The member's User ID.

플러그인버전

플러그인 버전 생성
client.Beta.Organization.Plugins.Versions.New(ctx, pluginID, params) (*BetaPluginVersion, error)
POST/v1/organizations/plugins/{plugin_id}/versions

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

플러그인 버전 목록 조회
client.Beta.Organization.Plugins.Versions.List(ctx, pluginID, params) (*PageCursor[BetaPluginVersion], error)
GET/v1/organizations/plugins/{plugin_id}/versions

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

플러그인 버전 조회
client.Beta.Organization.Plugins.Versions.Get(ctx, version, params) (*BetaPluginVersion, error)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

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

플러그인 버전 아카이브 다운로드
client.Beta.Organization.Plugins.Versions.Download(ctx, version, params) (*Response, error)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

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

플러그인설치 설정

플러그인 설치 설정 목록 조회
client.Beta.Organization.Plugins.InstallationSettings.List(ctx, pluginID, params) (*PageCursor[BetaPluginInstallationSetting], error)
GET/v1/organizations/plugins/{plugin_id}/installation_settings

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

플러그인 설치 설정 지정
client.Beta.Organization.Plugins.InstallationSettings.Set(ctx, target, params) (*BetaPluginInstallationSetting, error)
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

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

플러그인 설치 설정 제거
client.Beta.Organization.Plugins.InstallationSettings.Remove(ctx, target, params) (*BetaDeletedPluginInstallationSetting, error)
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

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

플러그인공유

플러그인 공유 목록 조회
client.Beta.Organization.Plugins.Shares.List(ctx, pluginID, params) (*PageCursor[BetaPluginShare], error)
GET/v1/organizations/plugins/{plugin_id}/shares

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