Roles

Conjunto de permisos de la organización que indica qué se puede hacer en cada módulo y en qué sitios, equipos o empresas.

Campos

El nombre API es el que usan la API, MCP y la CLI.

NombreNombre APITipoObligatorioDescripción
IDidID de registroSí
PosiciónrankOrdenSí
NombrelabelTexto I18nNombre visible del rol. Puede traducirse a múltiples idiomas.
ColorcolorColorSí
PermisospermissionsPermisosLíneas de permisos del rol: qué puede hacer y dónde (tabla.clave en módulo/entidad).
DescripcióndescriptionCampo de Texto I18nUna descripción opcional del rol. Puede traducirse a múltiples idiomas.
Creado porcreatedByUsuario
Creado elcreatedAtFecha y HoraSí
Actualizado porupdatedByUsuario
Actualizado elupdatedAtFecha y HoraSí
Bloqueado porblockedByUsuario
Bloqueado elblockedAtFecha y Hora
Archivado porarchivedByUsuario
Archivado elarchivedAtFecha y Hora

Acciones

Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook roles.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.

NombreNombre APIDescripciónDónde
CrearcreateCrea un rol.App · WebMCP · API · MCP · CLI
EditarupdateGuarda los cambios del rol.App · WebMCP · API · MCP · CLI
BloquearblockImpide editar y eliminar el rol. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo.App · WebMCP · API · MCP · CLI
DesbloquearunblockPermite de nuevo editar y eliminar el rol.App · WebMCP · API · MCP · CLI
ArchivararchiveRetira el rol del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívalo para restaurarlo.App · WebMCP · API · MCP · CLI
RestaurarunarchiveDevuelve el rol a las listas y las acciones activas.App · WebMCP · API · MCP · CLI
EliminardeleteElimina el rol y los datos que le pertenecen. No se puede deshacer.App · WebMCP · API · MCP · CLI