Claude Platform Docs

移除外掛程式安裝設定

$client->beta->organization->plugins->installationSettings->remove(string target, string pluginID, ?list<AnthropicBeta> betas): BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

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

移除 organization 目標會使外掛程式回到其市集的預設安裝設定，並保留各群組的設定。移除某個群組的設定後，該群組的成員會改為套用外掛程式的全組織設定，或其所屬其他群組的設定。

若目標本身沒有設定，會傳回 404（已繼承其市集預設值的外掛程式沒有 organization 設定），成員擁有的外掛程式也會傳回 404。

移除操作也算是外掛程式的安裝設定寫入之一：請一次傳送一個此類寫入請求。若同一個外掛程式同時收到多個請求，伺服器會依序處理，並可能對其中部分請求回應 503 及 x-should-retry: true 而不套用；請等待一兩秒後再次傳送移除請求。若重試時收到 404，表示該設定已被移除。

接受的憑證：具有 write:plugins 範圍的 Admin API 金鑰。

每個請求都必須包含 beta 標頭 anthropic-beta: ce-plugins-2026-09-01。缺少此標頭的請求會傳回 404，與端點不存在時完全相同。外掛程式 API 目前為 beta 版，僅供 Claude Enterprise 組織使用。Claude Platform（Claude Console）組織或已啟用 HIPAA 就緒功能的組織無法使用。

Parameters
pluginID: string⁠Path parameter

ID of the Plugin (prefixed plugin_).

target: string⁠Path parameter

The target whose own setting is removed: 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. Removing the organization setting returns the Plugin to its marketplace's default.

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class BetaDeletedPluginInstallationSetting { $type = 'plugin_installation_setting_deleted'; $pluginID; $target; }
"plugin_installation_setting_deleted" type

Always plugin_installation_setting_deleted.

string pluginID

The Plugin's ID.

Target target

Whose setting was removed.

移除外掛程式安裝設定
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaDeletedPluginInstallationSetting = $client
  ->beta
  ->organization
  ->plugins
  ->installationSettings
  ->remove(
  'target',
  pluginID: 'plugin_id',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaDeletedPluginInstallationSetting);
Returns Examples
Response 200
{
  "plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
  "target": {
    "rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
    "type": "rbac_group"
  },
  "type": "plugin_installation_setting_deleted"
}