Establecer configuración de instalación de Plugin
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.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.
Path parameters
Headers
Body
Returns
curl https://api.anthropic.com/v1/organizations/plugins/$PLUGIN_ID/installation_settings/$TARGET \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2026-10-21' \
-H 'anthropic-beta: ce-plugins-2026-09-01' \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-d '{
"installation_preference": "required"
}'{
"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"
}Returns Examples
{
"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"
}