GET/api/companies/{espacio}/semaforo

Si cada módulo del espacio funciona

Un color por módulo y el motivo en palabras: verde si funciona, y si no, por qué. Míralo cuando un módulo empiece a fallar, antes de reintentar.

PARÁMETROS

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

CAMPO	TIPO	QUÉ ES
modulos	{ [id]: { color, motivo } }	Uno por módulo activo, más `rag`, que es el asistente. No salen `rag-chat`, `documents` ni `api`: van con el asistente.
modulos.*.color	"verde" \| "amarillo" \| "rojo" \| "gris"	`gris`: el espacio no puede usarlo ahora. `rojo`: no responde. `amarillo`: le falta aplicar una conexión. `verde`: funciona. Si aplican varios, gana el primero.
modulos.*.motivo	string	El porqué, listo para enseñarlo. Lista abajo.
calculado	string (ISO 8601, UTC)	Cuándo se calculó.

STATUS	CUÁNDO	DETAIL LITERAL
403	La clave no llega a ese espacio	Sin acceso a este espacio.
404	El espacio no existe	Empresa no encontrada.
403	La API del espacio está apagada o tu IP no está en su lista	—

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

Los motivos posibles: «La prueba de tu espacio terminó.» y «La cuenta de tu espacio no está al día.» (todo el espacio en gris); «Se acabaron los créditos del espacio.» (gris); «No responde.» (rojo); «1 conexión sin aplicar.» o «N conexiones sin aplicar.» (amarillo); «Funcionando.» (verde).
Sin créditos solo se apaga lo que los gasta (el asistente, Agente ventas, Fuentes, Landings…). Productos, Facturación y los demás siguen en verde. Cuánto te queda, en la bolsa.
Las conexiones son las que se dibujan entre módulos en el Estudio. Un amarillo se resuelve solo cuando el módulo las aplica.
Se recuerda unos segundos: consultarlo más de una vez cada 10 s no da información nueva.