Claude Platform Docs

Establecer configuración de instalación de Plugin

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

Establece o cambia la configuración de instalación de un Plugin propiedad de la organización para toda la organización o para un grupo RBAC.

Escribir el valor que un destino ya tiene como propio no cambia nada.

Un Plugin propiedad de un miembro tiene comparticiones en lugar de configuraciones de instalación, por lo que esta ruta devuelve 404 para él.

Envía las escrituras de configuración de instalación de un Plugin de una en una. Si llegan varias escrituras para el mismo Plugin al mismo tiempo, el servidor las procesa una tras otra y puede responder a algunas de ellas con 503 en lugar de aplicarlas. Ese 503 incluye x-should-retry: true, y la escritura se puede repetir de forma segura: espera uno o dos segundos y luego vuelve a enviarla.

Credenciales aceptadas: una clave de API de administrador con el alcance write:plugins.

Cada solicitud debe incluir el encabezado beta anthropic-beta: ce-plugins-2026-09-01. Una solicitud sin él devuelve 404, exactamente como si el endpoint no existiera. La API de Plugins está en beta y solo está disponible para organizaciones de Claude Enterprise. No está disponible para organizaciones de Claude Platform (Claude Console) ni para organizaciones con la preparación para HIPAA habilitada.

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.

Establecer configuración de instalación de 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"
}