Claude Platform Docs

插件

创建插件
POST/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Create an organization-owned Plugin and its first version by uploading the version's files.

获取插件
GET/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

按 ID 检索插件。

更新插件
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Change which stored version of an organization-owned Plugin is served to members, for example to roll back to an earlier one. This pins the served version: later uploads are stored but no longer change what is served, and pinning cannot currently be undone, here or in claude.ai.

列出插件
GET/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

列出在组织下创建的插件，按从新到旧排序：包括组织自有插件市场中的插件以及成员个人插件市场中的插件。

删除插件
DELETE/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Permanently delete a Plugin and every version it holds, exactly as when an administrator deletes it in claude.ai. The Plugin may belong to the organization or to a member, including a member who has since left the organization. Do not delete a Plugin only because your pipeline did not create it: a member or an administrator might have added it in claude.ai.

Models
BetaDeletedPlugin object{ type: "plugin_deleted", id }
type: "plugin_deleted"

Always plugin_deleted.

defaultplugin_deleted
id: string

The deleted Plugin's ID.

BetaPlugin object{ type: "plugin", id, components, 16 more }
BetaPluginAPIActor object{ 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.

defaultapi_actor
api_key_id: string

The key's ID.

BetaPluginComponent object{ type, description, name }
type: "agent" or "cli" or "command" or 3 more

The kind of component.

One of the following:
"agent"
"cli"
"command"
"hook"
"mcp_server"
"skill"
description: string or null

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.

BetaPluginContentScan object{ assessment, reason, status }
assessment: "fail" or "pass" or "unknown" or "warn" or null

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"
"pass"
"unknown"
"warn"
reason: string or null

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" or "errored" or "processing"

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"
"errored"
"processing"
BetaPluginNameTakenErrorDetails object{ error_code, plugin_id }

The marketplace already holds this name. plugin_id is the Plugin that holds it, and can be absent.

error_code: "plugin_name_taken"
plugin_id: optional string or null
BetaPluginOwnerOrganization object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
BetaPluginOwnerUser object{ type: "user", user_id }
type: "user"

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

defaultuser
user_id: string

The member's User ID.

BetaPluginTargetOrganization object{ type: "organization" }
type: "organization"

Every member of the organization.

defaultorganization
BetaPluginTargetOrganizationMember object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

defaultorganization_member
user_id: string

The member's User ID.

BetaPluginTargetRBACGroup object{ type: "rbac_group", rbac_group_id }
type: "rbac_group"

An RBAC Group.

defaultrbac_group
rbac_group_id: string

The RBAC Group's ID.

BetaPluginUserActor object{ type: "user_actor", email_address, user_id }
type: "user_actor"

A member of the organization.

defaultuser_actor
email_address: string or null

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.

BetaRegistrationPendingErrorDetails object{ error_code, plugin_id, plugin_version_id }

The Plugin version was stored but is not yet usable in claude.ai. plugin_id and plugin_version_id identify what was stored.

error_code: "registration_pending"
plugin_id: string
plugin_version_id: string
BetaScanFailedErrorDetails object{ error_code, plugin_version_id }

The version in plugin_version_id did not pass its content scan, so it cannot be served.

error_code: "scan_failed"
plugin_version_id: string
BetaScanPendingErrorDetails object{ error_code, plugin_version_id }

The content scan of the version in plugin_version_id is still running. Retry once the scan finishes.

error_code: "scan_pending"
plugin_version_id: string
BetaSkillNameTakenErrorDetails object{ error_code, skill_name }

One of the Plugin's skills has the name of an organization skill. skill_name is that name.

error_code: "skill_name_taken"
skill_name: string

插件版本

创建插件版本
POST/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Add a version to an organization-owned Plugin by uploading the new version's files; it becomes the version served to members unless the Plugin's served version has been pinned.

列出插件版本
GET/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

列出插件的版本，按从新到旧排序。

获取插件版本
GET/v1/organizations/plugins/{plugin_id}/versions/{version}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

按 ID 检索插件的某个版本，或检索插件的最新版本。

下载插件版本归档
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

按原样下载某个版本的 .zip 归档文件。每次从成员个人插件市场下载插件都会记录在 Compliance API 活动源中。

插件安装设置

列出插件安装设置
GET/v1/organizations/plugins/{plugin_id}/installation_settings
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

列出组织所有插件的安装设置（这些设置说明插件面向哪些成员），按创建时间从新到旧排序。

设置插件安装设置
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

为整个组织或某个 RBAC 组设置或更改组织所有插件的安装设置。

移除插件安装设置
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

移除组织所有插件针对整个组织或某个 RBAC 组的自身安装设置。

插件共享

列出插件共享
GET/v1/organizations/plugins/{plugin_id}/shares
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

列出成员所有插件的所有者所授予的共享（共享给组织的所有成员、某个 RBAC 组或某个成员），按授予时间从新到旧排序。