Claude Platform Docs

外掛程式

建立外掛程式
BetaPlugin Beta.Organization.Plugins.Create(parameters, cancellationToken = default)
POST/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

取得外掛程式
BetaPlugin Beta.Organization.Plugins.Retrieve(parameters, cancellationToken = default)
GET/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

依 ID 擷取外掛程式。

更新外掛程式
BetaPlugin Beta.Organization.Plugins.Update(parameters, cancellationToken = default)
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

列出 Plugin
PluginListPage Beta.Organization.Plugins.List(parameters, cancellationToken = default)
GET/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

刪除 Plugin
BetaDeletedPlugin Beta.Organization.Plugins.Delete(parameters, cancellationToken = default)
DELETE/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

Models
class BetaDeletedPlugin { Type = "plugin_deleted"; ID; }
JsonElement Type = "plugin_deleted"

Always plugin_deleted.

required string ID

The deleted Plugin's ID.

class BetaPlugin { Type = "plugin"; ID; Components; /* 16 more */ }
class BetaPluginApiActor { Type = "api_actor"; ApiKeyID; }
JsonElement Type = "api_actor"

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

required string ApiKeyID

The key's ID.

class BetaPluginComponent { Type; Description; Name; }
required Type Type

The kind of component.

One of the following:
Agent("agent")
Cli("cli")
Command("command")
Hook("hook")
McpServer("mcp_server")
Skill("skill")
required string? Description

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

required 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 BetaPluginContentScan { Assessment; Reason; Status; }
required Assessment? Assessment

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

One of the following:
Fail("fail")
Pass("pass")
Unknown("unknown")
Warn("warn")
required 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.

required 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.

One of the following:
Completed("completed")
Errored("errored")
Processing("processing")
class BetaPluginOwnerOrganization { Type = "organization"; }
JsonElement Type = "organization"

The Plugin lives in a plugin marketplace the organization owns.

class BetaPluginOwnerUser { Type = "user"; UserID; }
JsonElement Type = "user"

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

required string UserID

The member's User ID.

class BetaPluginTargetOrganization { Type = "organization"; }
JsonElement Type = "organization"

Every member of the organization.

class BetaPluginTargetOrganizationMember { Type = "organization_member"; UserID; }
JsonElement Type = "organization_member"

One member of the organization.

required string UserID

The member's User ID.

class BetaPluginTargetRbacGroup { Type = "rbac_group"; RbacGroupID; }
JsonElement Type = "rbac_group"

An RBAC Group.

required string RbacGroupID

The RBAC Group's ID.

class BetaPluginUserActor { Type = "user_actor"; EmailAddress; UserID; }
JsonElement Type = "user_actor"

A member of the organization.

required string? EmailAddress

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

required string UserID

The member's User ID.

外掛程式版本

建立 Plugin 版本
BetaPluginVersion Beta.Organization.Plugins.Versions.Create(parameters, cancellationToken = default)
POST/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

透過上傳新版本的檔案，為組織擁有的 Plugin 新增版本；除非該 Plugin 所提供的版本已被釘選，否則新版本會成為向成員提供的版本。

列出 Plugin 版本
VersionListPage Beta.Organization.Plugins.Versions.List(parameters, cancellationToken = default)
GET/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出 Plugin 的版本，依最新優先排序。

取得 Plugin 版本
BetaPluginVersion Beta.Organization.Plugins.Versions.Retrieve(parameters, cancellationToken = default)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

依 ID 擷取 Plugin 的某個版本，或擷取 Plugin 的最新版本。

下載 Plugin 版本封存檔
HttpResponse Beta.Organization.Plugins.Versions.Download(parameters, cancellationToken = default)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

外掛程式安裝設定

列出 Plugin 安裝設定
InstallationSettingListPage Beta.Organization.Plugins.InstallationSettings.List(parameters, cancellationToken = default)
GET/v1/organizations/plugins/{plugin_id}/installation_settings
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出組織擁有的 Plugin 的安裝設定（用於指定該 Plugin 適用於哪些成員），依建立時間由新到舊排序。

設定 Plugin 安裝設定
BetaPluginInstallationSetting Beta.Organization.Plugins.InstallationSettings.Set(parameters, cancellationToken = default)
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

移除 Plugin 安裝設定
BetaDeletedPluginInstallationSetting Beta.Organization.Plugins.InstallationSettings.Remove(parameters, cancellationToken = default)
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

外掛程式分享

列出 Plugin 分享
ShareListPage Beta.Organization.Plugins.Shares.List(parameters, cancellationToken = default)
GET/v1/organizations/plugins/{plugin_id}/shares
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

列出成員擁有的 Plugin 的擁有者所提供的分享（分享給組織的所有成員、某個 RBAC 群組或單一成員），依授予時間由新到舊排序。