Claude Platform Docs

插件

创建插件
BetaPlugin beta().organization().plugins().create(params, requestOptions = RequestOptions.none())
POST/v1/organizations/plugins

通过上传版本文件,创建组织拥有的插件及其第一个版本。

获取插件
BetaPlugin beta().organization().plugins().retrieve(params = PluginRetrieveParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/plugins/{plugin_id}

按 ID 检索插件。

更新插件
BetaPlugin beta().organization().plugins().update(params, requestOptions = RequestOptions.none())
POST/v1/organizations/plugins/{plugin_id}

更改向成员提供的组织所有插件的已存储版本,例如回滚到较早的版本。此操作会固定所提供的版本:之后上传的版本仍会被存储,但不再改变所提供的内容,并且固定目前无法撤销,无论是在此处还是在 claude.ai 中。

列出插件
PluginListPage beta().organization().plugins().list(params = PluginListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/plugins

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

删除插件
BetaDeletedPlugin beta().organization().plugins().delete(params = PluginDeleteParams.none(), requestOptions = RequestOptions.none())
DELETE/v1/organizations/plugins/{plugin_id}

永久删除一个插件及其包含的所有版本,效果与管理员在 claude.ai 中删除它完全相同。该插件可以属于组织,也可以属于某个成员,包括此后已离开组织的成员。

Models
class BetaDeletedPlugin { type = "plugin_deleted"; id; }
JsonValue type = "plugin_deleted"

Always plugin_deleted.

String id

The deleted Plugin's ID.

class BetaPlugin { type = "plugin"; id; components; /* 16 more */ }
class BetaPluginApiActor { type = "api_actor"; apiKeyId; }
JsonValue type = "api_actor"

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

String apiKeyId

The key's ID.

class BetaPluginComponent { type; description; name; }
Type type

The kind of component.

One of the following:
AGENT("agent")
CLI("cli")
COMMAND("command")
HOOK("hook")
MCP_SERVER("mcp_server")
SKILL("skill")
Optional<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 BetaPluginContentScan { assessment; reason; status; }
Optional<Assessment> assessment

The scan's verdict; set only when status is completed.

One of the following:
FAIL("fail")
PASS("pass")
UNKNOWN("unknown")
WARN("warn")
Optional<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 or its outcome cannot be read.

One of the following:
COMPLETED("completed")
ERRORED("errored")
PROCESSING("processing")
class BetaPluginOwnerOrganization { type = "organization"; }
JsonValue type = "organization"

The Plugin lives in a plugin marketplace the organization owns.

class BetaPluginOwnerUser { type = "user"; userId; }
JsonValue type = "user"

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

String userId

The member's User ID.

class BetaPluginTargetOrganization { type = "organization"; }
JsonValue type = "organization"

Every member of the organization.

class BetaPluginTargetOrganizationMember { type = "organization_member"; userId; }
JsonValue type = "organization_member"

One member of the organization.

String userId

The member's User ID.

class BetaPluginTargetRbacGroup { type = "rbac_group"; rbacGroupId; }
JsonValue type = "rbac_group"

An RBAC Group.

String rbacGroupId

The RBAC Group's ID.

class BetaPluginUserActor { type = "user_actor"; emailAddress; userId; }
JsonValue type = "user_actor"

A member of the organization.

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

插件版本

创建插件版本
BetaPluginVersion beta().organization().plugins().versions().create(params, requestOptions = RequestOptions.none())
POST/v1/organizations/plugins/{plugin_id}/versions

通过上传新版本的文件为组织所有的插件添加一个版本;除非该插件的提供版本已被固定,否则新版本将成为向成员提供的版本。

列出插件版本
VersionListPage beta().organization().plugins().versions().list(params = VersionListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/plugins/{plugin_id}/versions

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

获取插件版本
BetaPluginVersion beta().organization().plugins().versions().retrieve(params, requestOptions = RequestOptions.none())
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

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

下载插件版本归档
HttpResponse beta().organization().plugins().versions().download(params, requestOptions = RequestOptions.none())
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

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

插件安装设置

列出插件安装设置
InstallationSettingListPage beta().organization().plugins().installationSettings().list(params = InstallationSettingListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/plugins/{plugin_id}/installation_settings

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

设置插件安装设置
BetaPluginInstallationSetting beta().organization().plugins().installationSettings().set(params, requestOptions = RequestOptions.none())
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

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

移除插件安装设置
BetaDeletedPluginInstallationSetting beta().organization().plugins().installationSettings().remove(params, requestOptions = RequestOptions.none())
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

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

插件共享

列出插件共享
ShareListPage beta().organization().plugins().shares().list(params = ShareListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/plugins/{plugin_id}/shares

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