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}

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

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

プラグインバージョンアーカイブのダウンロード
beta.organization.plugins.versions.download(version, **kwargs) -> StringIO
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

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

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

プラグインインストール設定の削除
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

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

プラグイン共有

プラグイン共有の一覧表示
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares

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