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}

組織所有のプラグインについて、保存されているどのバージョンをメンバーに提供するかを変更します。たとえば、以前のバージョンにロールバックする場合に使用します。これにより提供バージョンが固定されます。以降のアップロードは保存されますが、提供内容は変わらなくなります。また、固定は現在、ここでも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}

プラグインの1つのバージョンをIDで取得するか、プラグインの最新バージョンを取得します。

プラグインバージョンアーカイブのダウンロード
client.Beta.Organization.Plugins.Versions.Download(ctx, version, params) (*Response, error)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

1つのバージョンの .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}

組織所有のプラグインについて、組織全体または1つのRBACグループに対するインストール設定を設定または変更します。

プラグインインストール設定の削除
client.Beta.Organization.Plugins.InstallationSettings.Remove(ctx, target, params) (*BetaDeletedPluginInstallationSetting, error)
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

組織所有のプラグインについて、組織全体または1つのRBACグループに対する独自のインストール設定を削除します。

プラグイン共有

プラグイン共有の一覧表示
client.Beta.Organization.Plugins.Shares.List(ctx, pluginID, params) (*PageCursor[BetaPluginShare], error)
GET/v1/organizations/plugins/{plugin_id}/shares

メンバー所有のプラグインの所有者が行った共有(組織の全メンバー、RBACグループ、または1人のメンバーへの共有)を、付与日時の新しい順に一覧表示します。