Claude Platform Docs

設定 Plugin 安裝設定

beta.organization.plugins.installation_settings.set(target, **kwargs) -> BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

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

寫入目標本身已有的值不會造成任何變更。

成員擁有的 Plugin 使用的是分享而非安裝設定,因此對此類 Plugin,此路徑會傳回 404。

請一次傳送一個 Plugin 安裝設定的寫入請求。若同一個 Plugin 同時收到多個寫入請求,伺服器會依序處理,並可能對其中部分請求回應 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
plugin_id: str⁠Path parameter

ID of the Plugin (prefixed plugin_).

target: str⁠Path parameter

The target whose setting is written: the literal organization for the Plugin's organization-wide setting, or an RBAC Group's ID (prefixed rbac_group_) for that group's own setting. Writing the organization target stops the Plugin from inheriting its marketplace's default, even when the value written equals that default.

installation_preference: Literal["auto_install", "available", "not_available", "required"]

The installation setting the target is to hold for this Plugin: one of required, auto_install, available, not_available.

One of the following:
"auto_install"
"available"
"not_available"
"required"
betas: Optional[List[AnthropicBetaParam]]⁠Header parameter

This endpoint is in beta: requests must send ce-plugins-2026-09-01 in this header.

One of the following:
str
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
Returns
class BetaPluginInstallationSetting: type: "plugin_installation_setting"; created_at; installation_preference; ... # 3 more

The installation setting an organization-owned Plugin holds for one target. It has no ID of its own: it is addressed by the Plugin's ID and the target.

設定 Plugin 安裝設定
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)
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"
}