1. Menu Options - CRUD
Documentacion API MIOBOX
  • Raíz
    • Materials
      • Materiales
      • Materiales por Id
      • Create Material
      • Create Material Interfase
      • Update Material
      • Delete Material
      • Obtener materiales por controlador
      • Obtener materiales por línea
      • Obtener material por ID
      • Actualizar material
      • Eliminar material
      • Obtener todos los materiales
      • Crear material
      • Reactivar material eliminado
    • Materials v2
      • Materiales
      • Propagar a PLC
      • Materiales por Id
      • Materiales por Production Lines
      • Create Material
      • Create Material Copy
      • Update Material PLC
      • Create Material Interfase
      • Update Material
      • Delete Material
    • Recipes
      • Obtener recetas con filtros opcionales
      • Recetas por Linea de Produccion
      • Crear nueva receta
      • Update Recipe
      • Delete Recipe
      • Obtener receta por ID
      • Actualizar receta
      • Eliminar receta
    • Recipes v2
      • Recipes - Recetas
      • Create Recipes
      • Update Recipe
      • Delete Recipe
    • TypesDocuments
      • Get Types Documents
      • Get TypeDocument ById
      • Create Types Documents
      • Update TypeDocument
      • Delete TypeDocument
    • Auth
      • Users
        • Roles
          • Get Roles
          • Create Role
          • Update Role
          • Disable Role
        • Get Users
        • Get User by UID
        • Update User - Actualizar Usuario
        • Update User - Actualizar Usuario Copy
      • SignUp - Registrar Nuevo Usuario
      • Login de Usuario
      • Validar token (legacy)
      • Login de Usuario Copy
      • Verify Token Exprired Copy
      • Validar token con permisos (Gateway)
      • Renovar token
      • Cerrar sesion
      • Obtener token de servicio
      • Obtener info del usuario actual
      • Configuracion OIDC
      • Health check
    • Productions
      • Productions
      • ProductionById
      • New Production
      • Update Production
      • Update Production Copy
    • Production Lines
      • Obtiene todas las líneas de producción
      • Production Lines By Idc
      • Crea una nueva línea de producción
      • ProductionLineById
      • Update Production
      • Delete Production Line
      • {{url}}/api/productionline
    • Production Logs
      • Registros de produccion
      • Crear Registro
      • Crear Registro Copy
      • Actulizar bandera
      • Obtener registros de producción (Production Logs)
      • Crear evento de producción (desde PLC/MQTT)
      • Actualizar flag/migrate de un Production Log
    • Scales - Basculas
      • Clients
        • List Clients
        • List Clients Copy
        • Create Client
        • Update Client
        • Delete Client
      • Drivers
        • List Drivers
        • DriverById
        • Create Driver
        • Update Driver
        • Delete Driver
      • Origins
        • List Origins
        • OriginById
        • Create origin
        • Update Origin
        • Delete Origen
      • Destinations
        • List Destinations
        • DestinationById
        • Create Destination
        • Update Origin
        • Update Origin Copy
      • Products
        • List Products
        • ProductById
        • Create Product
        • Update Product
        • Delete Product
      • Sites
        • List Site
        • SiteById
        • Create Site
        • Update Site
        • Delete Site
      • Truck
        • List Truck
        • TrucksbyId
        • Create Truck
        • Update Truck
        • Delete Truck
      • Registers
        • All
        • ById
        • ByNumberPlate
        • Part 1 - Primer Pesaje
        • Part 1 - Primer Pesaje Copy
        • Update Product
        • Delete Register
      • Weight
        • All
        • ById
        • ByNumberPlate
        • Part 1 - Primer Pesaje
        • Update Product
        • Indicators (Semaforos)
        • Actuator (Talanquera) Copy
    • Grafics
      • Graficos Molino
      • Graficos kwton
    • Conf
      • connections
        • device
          • controller
            • Crear nueva conexión PLC
            • Nuevo Device Conn Copy
            • Modificar Device Conn Copy
      • Conf App
      • Conf App Set
    • Locations - Ubicaciones
      • Listar
      • Crear nueva
      • Modificar
      • Eliminar
    • Scheduling - Programacion de produccion
      • Obtiene la lista de schedules (programaciones de producción) con paginación
      • Enviar planes al PLC
      • Crea un nuevo schedule (programación de producción)
      • Listar Planes por Id
      • Actualizar un plan
      • Enviar Plan a PLC
      • Eliminar Plan
      • {{url}}/api/mes/scheduling
    • tools
      • units
        • units
        • Crear Unidad
        • Actualizar unidad
        • Actualizar unidad Copy
    • Proyectos
      • Aceptacion
        • Nueva aceptacion
        • Actualizar Aceptacion
        • Rechazo de acta
        • Firmar del contratista
        • Firma del cliente
        • Nuevo entregable
        • Buscar por Id o codeProject
        • {{url}}/api/project/acceptance/642b6984b3323611917f496f
    • Files
      • Upload
        • Cargar Archivo
        • Carga Multiple
        • Nuevo entregable
        • Buscar por Id
      • Subir un archivo
      • Subir múltiples imágenes
    • Users v2
      • Listar usuarios
      • Crear usuario
      • Obtener usuario por ID
      • Actualizar usuario
      • Eliminar usuario (soft delete)
      • Eliminar usuario permanentemente
      • Cambiar contrasena
      • Asignar rol a usuario
      • Remover rol de usuario
      • Habilitar usuario
      • Deshabilitar usuario
    • Roles v2
      • Listar roles
      • Crear rol
      • Obtener opciones de menu
      • Obtener rol por nombre
      • Actualizar rol
      • Eliminar rol
      • Obtener menu del rol
      • Actualizar menu del rol
      • Clonar rol
      • Sincronizar roles Keycloak-MongoDB
    • API Keys v2
      • Crear API Key
      • Listar API Keys
      • Obtener API Key
      • Actualizar API Key
      • Revocar API Key
      • Rotar API Key
    • API Tokens
      • Listar API Tokens
      • Crear nuevo API Token
      • Listar modulos disponibles para scopes
      • Obtener API Token por ID
      • Actualizar API Token
      • Revocar API Token
      • Regenerar API Key
    • Configuration
      • Obtener configuración de la empresa activa
      • Actualizar configuración de la empresa
      • Crear conexión de dispositivo controlador
      • Actualizar conexión de dispositivo controlador
    • Node-RED
      • Verificar conexión con Node-RED
      • Sincronizar todos los widgets con Node-RED
      • Sincronizar widgets de un dashboard con Node-RED
    • Dashboards
      • Obtener todos los topics MQTT para Node-RED
      • Obtener todos los dashboards del usuario
      • Crear un nuevo dashboard
      • Obtener un dashboard por ID
      • Actualizar un dashboard
      • Eliminar un dashboard
      • Duplicar un dashboard
    • Widgets
      • Obtener todos los widgets de un dashboard
      • Crear un nuevo widget
      • Obtener un widget por ID
      • Actualizar un widget
      • Eliminar un widget (soft delete)
      • Obtener información de series MQTT del widget
      • Cambiar entre tópico auto y personalizado
      • Regenerar topics automáticos de series MQTT
      • Actualizar metadata del widget
      • Obtener todas las series de un widget
      • Agregar nueva serie a un widget
      • Obtener estadísticas de series de un widget
      • Obtener una serie específica
      • Actualizar serie existente
      • Eliminar serie de un widget
    • KPI Catalog
      • Listar catalogo de KPIs
      • Crear consulta KPI
      • Obtener consulta KPI por ID
      • Actualizar consulta KPI
      • Eliminar consulta KPI
      • Crear nueva version de consulta KPI
      • Validar consulta KPI por experto
      • Activar/desactivar consulta KPI
    • PLC Parameters
      • Crear nuevo parámetro PLC
      • Listar todos los parámetros PLC
      • Actualizar parámetro PLC existente
      • Eliminar parámetro PLC
    • Production
      • Obtener todas las producciones
      • Crear nueva producción
      • Obtener producción por ID
      • Actualizar producción
      • Eliminar producción
    • ProductionLines
      • Obtiene una línea de producción por ID
      • Actualiza una línea de producción
      • Elimina una línea de producción (soft delete)
      • Obtiene línea de producción por ID de controlador (legacy)
    • Production Records
      • Registrar un evento de producción (desde Frontend/UI)
      • Obtener eventos de un Schedule
    • Scheduling - CRUD
      • Obtiene un schedule específico por su ID o scheduleNumber
      • Actualiza un schedule existente
      • Elimina un schedule
      • Busca schedules por número de lote (scheduleNumber)
      • Actualiza las fechas de un schedule mediante drag & drop en calendario
    • Scheduling - Legacy
      • Compatibility
        • [LEGACY] Envía un schedule al PLC
        • [LEGACY] Inicia la producción de un schedule
        • [LEGACY] Detiene la producción de un schedule
    • Scheduling - State Management
      • Transiciona un schedule a un nuevo estado usando StateManager
      • Obtiene el historial completo de transiciones de estado de un schedule
      • Obtiene las acciones y transiciones permitidas para el estado actual de un schedule
    • Scheduling - Actions
      • Confirma un schedule (DRAFT → SCHEDULED)
      • Pausa una producción en curso
      • Reanuda una producción pausada
      • Marca una producción como completada
      • Cancela un schedule
      • Cierra un schedule completado
    • Scheduling - KPIs
      • Obtiene KPIs del catálogo aplicables a schedules
      • Obtiene todos los KPIs aplicables a un schedule
      • Obtiene KPIs heredados de la línea de producción
      • Obtiene resumen de KPIs por grupo ISA-95
      • Verifica si un schedule tiene KPIs activos
      • Obtiene valores calculados de KPIs para un schedule
    • Connections
      • Listar todas las conexiones
      • Obtener alias disponibles para escritura
      • Obtener conexión por ID
      • Actualizar conexión existente
      • Eliminar conexión
    • Tasks
      • Crear nueva tarea de automatización
      • Listar todas las tareas
      • Actualizar tarea existente
      • Eliminar tarea
    • Grafana Dashboards
      • Crear un nuevo dashboard de Grafana
      • Obtener todos los dashboards de Grafana
      • Actualizar un dashboard de Grafana por ID
      • Eliminar un dashboard de Grafana (soft delete)
    • Menu Options - CRUD
      • Crea una nueva opción de menú
        POST
      • Obtiene todas las opciones de menú activas
        GET
      • Obtiene opciones de menú por ID de aplicación
        GET
      • Actualiza una opción de menú por ID
        PUT
      • Elimina (soft delete) una opción de menú por ID
        DELETE
    • Node-RED Environments
      • Obtener todos los entornos Node-RED
      • Crear nuevo entorno Node-RED
      • Obtener un entorno por slug
      • Actualizar un entorno
      • Eliminar un entorno
      • Iniciar un entorno Node-RED
      • Detener un entorno Node-RED
      • Reiniciar un entorno Node-RED
      • Obtener estado actual del entorno
      • Obtener logs del entorno
      • Regenerar API token del entorno
      • Obtener API token del entorno
      • Obtener URL del editor Node-RED
      • Resolver target interno para proxy
    • Iniciar sesion
      POST
  • Schemas
    • LoginDto
    • LoginResponse
    • UserInfo
    • ValidateWithPermissionsDto
    • ValidateResponse
    • GatewayUserInfo
    • RefreshTokenDto
    • TokenPairResponse
    • ServiceTokenDto
    • CreateUserDto
    • UpdateUserDto
    • UserResponse
    • UsersListResponse
    • ChangePasswordDto
    • MenuItem
    • CreateRoleDto
    • UpdateRoleDto
    • RolePermission
    • RoleResponse
    • CreateApiKeyDto
    • UpdateApiKeyDto
    • ApiKeyResponse
    • ApiKeyCreatedResponse
    • ErrorResponse
    • SuccessMessage
    • ApiToken
    • ApiTokenCreate
    • ApiTokenCreatedResponse
    • ApiTokenUpdate
    • AvailableModule
    • Widget
    • KpiCatalogEntry
    • KpiCatalogCreate
    • PlcTag
    • ParameterPlc
    • ParameterPlcInput
    • KPI
    • ProductionLine
    • ProductionLineInput
    • ProductionLog
    • ProductionLogInput
    • Measurement
    • Event
    • ConnectionTag
    • Connection
    • ConnectionInput
    • TaskConstant
    • TaskFormulaElement
    • TaskOperation
    • Task
    • TaskInput
    • GrafanaDashboard
    • Option
  1. Menu Options - CRUD

Crea una nueva opción de menú

Entorno prueba
https://test.your-api-server.com
Entorno prueba
https://test.your-api-server.com
POST
https://test.your-api-server.com
/api/menu/option
Menu Options - CRUD
Última modificación:2026-03-30 00:53:56
Permite crear una nueva opción de menú con sus propiedades. El campo _idOption se auto-incrementa automáticamente.

Solicitud

Autorización
JWT Bearer
Agregar el parámetro
Authorization
a Encabezados
Ejemplo:
Authorization: ********************
or
Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201
application/json
Opción creada exitosamente
Body

🟠400
🟠401
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://test.your-api-server.com/api/menu/option' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "Dashboard Principal",
    "link": "/dashboard",
    "description": "Panel principal con métricas del sistema"
}'
Respuesta Ejemplo de Respuesta
201 - success
{
    "msg": "Opción creada",
    "optionSaved": {
        "_id": "507f1f77bcf86cd799439011",
        "_idOption": 5,
        "text": "Gestión de Producción",
        "link": "/production/management",
        "apps": [
            "507f1f77bcf86cd799439012"
        ],
        "description": "Módulo para gestionar órdenes de producción",
        "deleted": false,
        "createdAt": "2025-10-18T19:00:00.000Z",
        "updatedAt": "2025-10-18T19:00:00.000Z"
    }
}
Modificado en 2026-03-30 00:53:56
Anterior
Eliminar un dashboard de Grafana (soft delete)
Siguiente
Obtiene todas las opciones de menú activas
Built with