Claude Platform Docs

Establecer configuración de instalación de Plugin

$ ant beta:organization:plugins:installation-settings set
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: 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.

--installation-preference: "auto_install" or "available" or "not_available" or "required"

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

--beta: optional array of AnthropicBeta⁠Header parameter

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

Returns
beta_plugin_installation_setting: object{ 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.

type: "plugin_installation_setting"

Always plugin_installation_setting.

created_at: string

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

formatdate-time
installation_preference: "auto_install" or "available" or "not_available" or "required"

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.

One of the following:
"auto_install"
"available"
"not_available"
"required"
plugin_id: string

The Plugin's ID.

target: BetaPluginTargetOrganization or BetaPluginTargetRBACGroup or BetaPluginTargetOrganizationMember

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.

One of the following:
beta_plugin_target_organization: object{ type: "organization" }
type: "organization"

Every member of the organization.

beta_plugin_target_rbac_group: object{ type: "rbac_group", rbac_group_id }
type: "rbac_group"

An RBAC Group.

rbac_group_id: string

The RBAC Group's ID.

beta_plugin_target_organization_member: object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

user_id: string

The member's User ID.

updated_at: string

When its setting last changed.

formatdate-time
Establecer configuración de instalación de Plugin
ant beta:organization:plugins:installation-settings set \
  --api-key my-anthropic-api-key \
  --plugin-id plugin_id \
  --target target \
  --installation-preference required
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"
}