设置插件安装设置
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
为整个组织或某个 RBAC 组设置或更改组织所有插件的安装设置。
写入目标自身已持有的值不会产生任何更改。
成员所有的插件使用共享而非安装设置,因此对此类插件,此路径返回 404。
请逐个发送插件的安装设置写入请求。如果同一插件的多个写入请求同时到达,服务器会依次处理它们,并可能对其中一些返回 503 而不应用。该 503 响应带有 x-should-retry: true,且该写入可以安全地重复:请等待一两秒,然后再次发送。
**接受的凭据:**具有 write:plugins 作用域的 Admin API 密钥。
每个请求都必须包含 beta 标头 anthropic-beta: ce-plugins-2026-09-01。缺少该标头的请求将返回 404,与端点不存在时完全相同。Plugins API 目前处于 beta 阶段,仅适用于 Claude Enterprise 组织。Claude Platform(Claude Console)组织以及启用了 HIPAA 就绪功能的组织无法使用。
Parameters
Returns
设置插件安装设置
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get(
"ANTHROPIC_API_KEY"
), # This is the default and can be omitted
)
beta_plugin_installation_setting = (
client.beta.organization.plugins.installation_settings.set(
target="target",
plugin_id="plugin_id",
installation_preference="required",
)
)
print(beta_plugin_installation_setting.plugin_id)Response 200
{
"created_at": "2026-03-14T09:26:53.589793Z",
"installation_preference": "required",
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"target": {
"type": "organization"
},
"type": "plugin_installation_setting",
"updated_at": "2026-03-14T09:26:53.589793Z"
}Returns Examples
Response 200
{
"created_at": "2026-03-14T09:26:53.589793Z",
"installation_preference": "required",
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"target": {
"type": "organization"
},
"type": "plugin_installation_setting",
"updated_at": "2026-03-14T09:26:53.589793Z"
}