PATCH/api/companies/{espacio}/modules

Activa o quita módulos del espacio

Manda la lista completa de módulos que quieres en el espacio: lo nuevo se activa y lo que falte se quita. Solo frena lo que pase del cupo: míralo antes en limite.

PERMISOescribe
CRÉDITOSno gasta
AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPO	TIPO	REQUERIDO	QUÉ ES
espacio	string	SÍ	El id del espacio (sale en GET /api/companies).

CUERPO · JSON

CAMPO	TIPO	REQUERIDO	QUÉ ES
modules	string[]	SÍ	La lista entera, no un cambio: incluye `rag-chat`, `documents` y los que ya tienes y quieres conservar.

RESPUESTA 200

CAMPO	TIPO	QUÉ ES
modules	string[]	La lista guardada.
cableado	array	Al quitar un módulo, sus conexiones con los demás se apagan. Una entrada por conexión: `{ de, a, encender, estado, detalle, etiqueta }`, con `estado` `aplicado` o `pendiente`. [] si no quitaste nada.
prompt_cerebro	object	Solo al activar `ventas`. `estado`: `aplicado` (el asistente pasa a hablar como la tienda; `campos` dice qué cambió), `especializado` (ya tenía instrucciones propias y no se tocaron) o `no_disponible`.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUS	CUÁNDO	DETAIL LITERAL
403	Clave de solo lectura	Tu cuenta es de solo lectura en este espacio.
404	El espacio no existe	Empresa no encontrada.
409	Quitas rag-chat o documents	«<modulo>» viene con todo espacio y no se puede quitar.
409	Un id que no existe	«<modulo>» no es un módulo de Bentho.
409	Modo manual: un módulo fuera de habilitados	«<modulo>» no está habilitado para este espacio. Pídeselo a tu asesor.
409	Sin plan: más de 5 módulos	Tu espacio incluye hasta 5 módulos y este cambio dejaría <N>. Quita uno o elige un plan.
409	Más módulos de los que incluye el plan	Tu plan incluye <N> módulo(s) y este cambio dejaría <M>. Quita uno o mejora tu plan.
409	Más conectores de los que incluye el plan	Tu plan incluye <N> conector(es) y este cambio dejaría <M>. Quita uno o mejora tu plan.
422	Falta modules o no es una lista	—

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

CONVIENE SABER

Quitar siempre se puede. Un cambio que no suma módulos tampoco se rechaza, aunque el espacio ya esté por encima del cupo (por ejemplo, tras bajar de plan).
Activar ventas cambia la forma de la respuesta de conversations: revisa tu integración antes.
Una conexión pendiente es un módulo que no respondió al apagarla: se puede reintentar desde el Estudio. Si vuelves a activar el módulo, sus conexiones se recuperan desde allí.
Sin api, el espacio ya no tiene Bentho API contratado y PATCH api-config responde 403.