Hyperion
    Hyperion
    • JSON-RPC API Introduction
    • JSON-API Commands Overview
    • Connect to Hyperion
    • Components & Priorities
    • Hyperion API
      • Authorization
        • API Authentication - Introduction
        • createToken
        • renameToken
        • deleteToken
        • getTokenlist
        • tokenRequired
        • adminRequired
        • newPasswordRequired
        • requestToken
        • newPassword
        • answerRequest
        • getPendingTokenRequests
        • login
        • logout
      • Information
        • getSystemInformation
        • getSubscriptionInformation
        • getServerInformation
        • getImageSnapshot
        • getLedsSnapshot
      • Controls
        • Input Controls
          • setColor
          • setEffect
          • setImage
          • clear
          • clearAll
          • selectSource
        • Output Controls
          • adjustColors
          • setLedMapping
          • setVideomode
        • Subscription Controls
          • liveImageStream
          • liveLedColorStream
        • Operational Controls
          • setComponentState
          • setInstanceState
          • switchInstance
          • setSystemState
          • setSubscriptions
      • Configuration
        • createInstance
        • deleteInstance
        • renameInstance
        • getConfiguration
        • updateConfiguration
        • restoreConfiguration
        • getSchemas

    JSON-API Commands Overview

    Commands & Sub-Commands#

    List of commands and related sub-commands which can be used via JSON-API requests.
    Authorization (via password or bearer token)
    No - No authorization required
    Yes - Authorization required, but can be disabled for local network calls
    Admin: Authorization is always required
    Instance Cmd
    Single - A specific instance can be addressed
    Multi - Multiple instances can be addressed via one request
    No - The command is not instance related
    Instance must Run
    No - The instance is not required to run
    Yes - The instance the command is to be applied to must be running
    http/s Support
    Yes - Command can be used by individual http/s requests
    No - Applies only to WebSocket or http/s sessions
    CommandSub-CommandAuthorizationInstance CmdInstance must Runhttp/s Support
    adjustmentYesMultiYesYes
    authorizeadminRequiredNoNoNoYes
    authorizeanswerRequestAdminNoNoNo
    authorizecreateTokenAdminNoNoNo
    authorizedeleteTokenAdminNoNoYes
    authorizegetPendingTokenRequestsAdminNoNoNo
    authorizegetTokenListAdminNoNoYes
    authorizeloginNoNoNoNo
    authorizelogoutNoNoNoNo
    authorizenewPasswordAdminNoNoYes
    authorizenewPasswordRequiredNoNoNoYes
    authorizerenameTokenAdminNoNoYes
    authorizerequestTokenNoNoNoYes
    authorizetokenRequiredNoNoNoYes
    clearYesMultiYesYes
    clearallYesMultiYesYes
    colorYesMultiYesYes
    componentstateYesNo or MultiYesYes
    configgetconfigAdminNoNoYes
    configgetschemaAdminNoNoYes
    configreloadAdminNoNoYes
    configrestoreconfigAdminNoNoYes
    configsetconfigAdminNoNoYes
    correctionYesSingleYesYes
    create-effectYesNoNoYes
    delete-effectYesNoNoYes
    effectYesMultiYesYes
    imageYesMultiYesYes
    inputsourcediscoverYesNoNoYes
    inputsourcegetPropertiesYesNoNoYes
    instancecreateInstanceAdminNoNoYes
    instancedeleteInstanceAdminNoNoYes
    instancesaveNameAdminNoNoYes
    instancestartInstanceYesNoNoYes
    instancestopInstanceYesNoNoYes
    instanceswitchToYesNoNoYes
    instance-datagetImageSnapshotYesSingleYesYes
    instance-datagetLedSnapshotYesSingleYesYes
    ledcolorsimagestream-startYesSingleYesNo
    ledcolorsimagestream-stopYesSingleYesNo
    ledcolorsledstream-startYesSingleYesNo
    ledcolorsledstream-stopYesSingleYesNo
    leddeviceaddAuthorizationYesSingleYesYes
    leddevicediscoverYesNoNoYes
    leddevicegetPropertiesYesNoNoYes
    leddeviceidentifyYesNoNoYes
    loggingstartYesNoNoYes
    loggingstopYesNoNoYes
    processingYesMultiYesYes
    serverinfoYesSingleYesYes
    serverinfogetInfoYesNo or SingleYesYes
    serverinfosubscribeYesNo or SingleYesNo
    serverinfounsubscribeYesNo or SingleYesNo
    serverinfogetSubscriptionsYesNo or SingleYesNo
    serverinfogetSubscriptionCommandsNoNoNoNo
    servicediscoverYesNoNoYes
    sourceselectYesMultiYesYes
    sysinfoYesNoNoYes
    systemrestartYesNoNoYes
    systemresumeYesNoNoYes
    systemsuspendYesNoNoYes
    systemtoggleSuspendYesNoNoYes
    systemidleYesNoNoYes
    systemtoggleIdleYesNoNoYes
    temperatureYesSingleYesYes
    transformYesSingleYesYes
    videomodeYesNoNoYes

    Subscription updates#

    List of updates which can be subscribed to via the serverinfo/subscriberequest.
    Instance specific
    Yes - A specific instance can be addressed
    No - The command is not instance related
    in "all"
    Yes - Updates are subscribed using "all" as the command
    No - Subscription is only triggered via JSON-API request
    Subscription CommandInstance specificin "all"
    adjustment-updateYesYes
    components-updateYesYes
    effects-updateYesYes
    event-updateNoYes
    imageToLedMapping-updateYesYes
    instance-updateYesYes
    ledcolors-imagestream-updateYesNo
    ledcolors-ledstream-updateYesNo
    leds-updateYesYes
    logmsg-updateNoNo
    priorities-updateYesYes
    settings-updateYesYes
    token-updateNoYes
    videomode-updateNoYes
    Previous
    JSON-RPC API Introduction
    Next
    Connect to Hyperion
    Built with