Workspaces

Un workspace es la unidad de cuenta de Prysm:ID. Es lo que vos creás cuando te registrás. Cada workspace tiene:

Un slug inmutable (acme).
Un dominio de auth (auth.acme.prysmid.com).
Una instancia dedicada.
Un plan (Free / Pro / Enterprise).
Un owner (la cuenta humana que lo creó).
Un set de miembros con roles.

Un workspace está pensado para representar un producto SaaS tuyo. Si tenés varios productos independientes, tenés varios workspaces. Si tenés un producto con muchos clientes B2B, tenés un workspace y muchos tenants dentro.

Estados del workspace

Estado	Qué significa
`provisioning`	Acabamos de crear el workspace. Estamos levantando la instancia dedicada, configurando DNS, dejando todo listo. Toma 60-90 s.
`active`	Listo para uso. Login, dashboard, API, MCP — todo disponible.
`past_due`	Falló un pago. La instance sigue activa, pero el dashboard muestra un banner. Si no se resuelve en 14 días, pasa a `suspended`.
`suspended`	Pago no resuelto. Login para usuarios desactivado; el data plane responde 503. Recuperable: pagás y vuelve a `active`.
`failed_provisioning`	Algo falló al crear. Recoverable sin perder el slug; escribinos.

Miembros y roles

Cada workspace tiene miembros (cuentas humanas con acceso al dashboard). Los roles iniciales son:

Owner — el que creó el workspace. No removible. Único que puede borrar el workspace o transferir ownership.
Admin — todo menos borrar workspace o transferir.
Developer — registrar/editar apps, ver audit logs, no puede invitar miembros ni cambiar billing.
Billing — solo billing y plan changes, sin acceso a auth config.

Plan y MAU

El plan determina los límites del workspace. Ver pricing para la tabla completa. Lo importante:

MAU = Monthly Active Users: usuarios distintos que se autenticaron al menos una vez en el período facturado actual. Lo medimos vía el audit log de tu instancia.
En Pro, los primeros 100k MAU están incluidos en el flat. Sobre eso, $0.02 por MAU.
Podés definir un spending cap. Si la proyección de overage cruzaría el cap, bloqueamos signups nuevos hasta el próximo período. No te facturamos más allá de tu cap, pero los usuarios existentes siguen pudiendo loguearse.

Operaciones disponibles

Todo lo que hacés en el dashboard tiene contraparte API y MCP. Las operaciones core sobre un workspace:

Crear / leer / borrar
Listar miembros / invitar / remover / cambiar rol
Cambiar plan / setear spending cap / abrir Customer Portal de Stripe
Listar apps registradas / crear / eliminar
Listar IdPs configurados / agregar / remover
Editar branding (logo, colores, dominio custom)
Webhooks: crear, listar, rotar secret

Ver /reference/api para la spec completa, o /agents/tools para el catálogo MCP.