Claude Platform Docs

Plugin-Installationseinstellung festlegen

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

Legt die Installationseinstellung eines organisationseigenen Plugins für die gesamte Organisation oder für eine RBAC-Gruppe fest oder ändert sie.

Das Schreiben des Werts, den ein Ziel bereits selbst hat, ändert nichts.

Ein mitgliedseigenes Plugin hat statt Installationseinstellungen Freigaben, daher gibt dieser Pfad dafür 404 zurück.

Sende die Schreibvorgänge für die Installationseinstellungen eines Plugins einzeln nacheinander. Wenn mehrere Schreibvorgänge für dasselbe Plugin gleichzeitig eintreffen, verarbeitet der Server sie nacheinander und kann einige davon mit 503 beantworten, statt sie anzuwenden. Diese 503 enthält x-should-retry: true, und der Schreibvorgang kann gefahrlos wiederholt werden: Warte ein oder zwei Sekunden und sende ihn dann erneut.

Akzeptierte Anmeldedaten: ein Admin-API-Key mit dem Scope write:plugins.

Jede Anfrage muss den Beta-Header anthropic-beta: ce-plugins-2026-09-01 enthalten. Eine Anfrage ohne ihn gibt 404 zurück, genau so, als ob der Endpunkt nicht existieren würde. Die Plugins API befindet sich in der Beta und ist nur für Claude Enterprise-Organisationen verfügbar. Sie ist nicht für Claude Platform (Claude Console)-Organisationen oder für Organisationen mit aktivierter HIPAA-Readiness verfügbar.

Parameters
pluginID: string⁠Path parameter

ID of the Plugin (prefixed plugin_).

target: string⁠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.

installationPreference: InstallationPreference

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

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class BetaPluginInstallationSetting { $type = 'plugin_installation_setting'; $createdAt; $installationPreference; /* 3 more */ }
"plugin_installation_setting" type

Always plugin_installation_setting.

\Datetime createdAt

When the target was first given a setting for this Plugin.

InstallationPreference installationPreference

The setting the target holds for this Plugin. One of required, auto_install, available, not_available; a value this API does not yet name is returned as stored.

string pluginID

The Plugin's ID.

Target target

Whose setting this is: organization (the Plugin's own organization-wide setting) or rbac_group (one RBAC Group's own setting); organization_member does not occur here.

\Datetime updatedAt

When its setting last changed.

Plugin-Installationseinstellung festlegen
<?php

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

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

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

$betaPluginInstallationSetting = $client
  ->beta
  ->organization
  ->plugins
  ->installationSettings
  ->set(
  'target',
  pluginID: 'plugin_id',
  installationPreference: 'required',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaPluginInstallationSetting);
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"
}