Claude Platform Docs

外掛程式

建立外掛程式
$client->beta->organization->plugins->create(list<FileParam | string> files, ?string marketplaceID, ?string releaseNotes, ?list<AnthropicBeta> betas): Plugin
POST/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

上傳版本的檔案,以建立組織擁有的外掛程式(Plugin)及其 第一個版本。

取得外掛程式
$client->beta->organization->plugins->retrieve(string pluginID, ?string organizationID, ?list<AnthropicBeta> betas): Plugin
GET/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

依 ID 擷取外掛程式。

更新外掛程式
$client->beta->organization->plugins->update(string pluginID, string servedVersionID, ?list<AnthropicBeta> betas): Plugin
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

變更向成員提供的組織擁有外掛程式的已儲存版本,例如回復到較早的版本。這會釘選所提供的版本:之後上傳的版本仍會儲存,但不再改變所提供的內容,且目前無法取消釘選,無論在此處或在 claude.ai 中皆然。

列出外掛程式
$client->beta->organization->plugins->list(?\Datetime createdAtGt, ?\Datetime createdAtGte, ?\Datetime createdAtLt, ?\Datetime createdAtLte, ?int limit, ?string marketplaceID, ?string organizationID, ?OwnerType ownerType, ?string ownerUserID, ?string page, ?list<AnthropicBeta> betas): PageCursor<Plugin>
GET/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出在組織下建立的外掛程式,依最新優先排序:包括組織自有外掛程式市集中的外掛程式,以及成員個人外掛程式市集中的外掛程式。

刪除外掛程式
$client->beta->organization->plugins->delete(string pluginID, ?list<AnthropicBeta> betas): DeletedPlugin
DELETE/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

永久刪除外掛程式及其所有版本,效果與管理員在 claude.ai 中刪除時完全相同。該外掛程式可以屬於組織或成員,包括已離開組織的成員。

Models
class DeletedPlugin { $type = 'plugin_deleted'; $id; }
"plugin_deleted" type

Always plugin_deleted.

string id

The deleted Plugin's ID.

class Plugin { $type = 'plugin'; $id; $components; /* 16 more */ }
class PluginAPIActor { $type = 'api_actor'; $apiKeyID; }
"api_actor" type

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

string apiKeyID

The key's ID.

class PluginComponent { $type; $description; $name; }
Type type

The kind of component.

?string description

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

string name

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 PluginContentScan { $assessment; $reason; $status; }
?Assessment assessment

The scan's verdict; set only when status is completed. A warn can mean a fail that was allowed in claude.ai.

?string reason

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 status

processing while a scan runs, completed when it ran to completion, errored when it could not run. Once a scan of the version has completed, content_scan describes the newest completed scan, even while a later scan runs. While the scan outcome cannot be read, status is errored instead.

class PluginOwnerOrganization { $type = 'organization'; }
"organization" type

The Plugin lives in a plugin marketplace the organization owns.

class PluginOwnerUser { $type = 'user'; $userID; }
"user" type

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

string userID

The member's User ID.

class PluginTargetOrganization { $type = 'organization'; }
"organization" type

Every member of the organization.

class PluginTargetOrganizationMember { $type = 'organization_member'; $userID; }
"organization_member" type

One member of the organization.

string userID

The member's User ID.

class PluginTargetRBACGroup { $type = 'rbac_group'; $rbacGroupID; }
"rbac_group" type

An RBAC Group.

string rbacGroupID

The RBAC Group's ID.

class PluginUserActor { $type = 'user_actor'; $emailAddress; $userID; }
"user_actor" type

A member of the organization.

?string emailAddress

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

string userID

The member's User ID.

外掛程式版本

建立外掛程式版本
$client->beta->organization->plugins->versions->create(string pluginID, list<FileParam | string> files, ?string releaseNotes, ?list<AnthropicBeta> betas): BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

透過上傳新版本的檔案,為組織擁有的外掛程式新增版本;除非該外掛程式所提供的版本已被釘選,否則新版本會成為向成員提供的版本。

列出外掛程式版本
$client->beta->organization->plugins->versions->list(string pluginID, ?int limit, ?string organizationID, ?string page, ?list<AnthropicBeta> betas): PageCursor<BetaPluginVersion>
GET/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出外掛程式的版本,依最新優先排序。

取得外掛程式版本
$client->beta->organization->plugins->versions->retrieve(string version, string pluginID, ?string organizationID, ?list<AnthropicBeta> betas): BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

依 ID 擷取外掛程式的某個版本,或擷取外掛程式的最新版本。

下載外掛程式版本封存檔
$client->beta->organization->plugins->versions->download(string version, string pluginID, ?string organizationID, ?list<AnthropicBeta> betas): download
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

下載某個版本的 .zip 封存檔,內容與儲存時完全相同。每次從成員個人外掛程式市集下載外掛程式,都會記錄在 Compliance API 活動摘要中。

外掛程式安裝設定

列出外掛程式安裝設定
$client->beta->organization->plugins->installationSettings->list(string pluginID, ?int limit, ?string organizationID, ?string page, ?TargetType targetType, ?list<AnthropicBeta> betas): PageCursor<BetaPluginInstallationSetting>
GET/v1/organizations/plugins/{plugin_id}/installation_settings
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出組織擁有的外掛程式的安裝設定(用於指定該外掛程式適用於哪些成員),依建立時間由新到舊排序。

設定外掛程式安裝設定
$client->beta->organization->plugins->installationSettings->set(string target, string pluginID, InstallationPreference installationPreference, ?list<AnthropicBeta> betas): BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

為整個組織或單一 RBAC 群組設定或變更組織擁有的外掛程式的安裝設定。

移除外掛程式安裝設定
$client->beta->organization->plugins->installationSettings->remove(string target, string pluginID, ?list<AnthropicBeta> betas): BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

移除組織擁有的外掛程式針對整個組織或單一 RBAC 群組本身的安裝設定。

外掛程式分享

列出外掛程式分享
$client->beta->organization->plugins->shares->list(string pluginID, ?int limit, ?string organizationID, ?string page, ?TargetType targetType, ?list<AnthropicBeta> betas): PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出成員擁有的外掛程式的擁有者所提供的分享(分享給組織的所有成員、某個 RBAC 群組或單一成員),依授予時間由新到舊排序。