Displays: Feature Flags

Use these query parameters with the versioned display client endpoint to toggle printing, file transfer, video encoding, MediaSource video, and notification features. The endpoint serves the HTML5 client interface; the flags documented here control which capabilities the loaded client exposes to the end user, independent of session-level settings on the server.

This page covers only the feature-toggle subset of the URL parameters accepted by the client endpoint. Routing parameters, rendering parameters, input parameters, clipboard parameters, sharing parameters, and debug flags are documented separately.

`GET /api/v1/display/`

Serves the HTML5 display client web interface with URL-based feature configuration. This is the standardized API version of the root display endpoint and accepts the same query parameters, including the feature-toggle flags listed below.

Parameters

Name	In	Type	Required	Description
`printing`	query	boolean	No	Enable printing support. Default: `true`
`file_transfer`	query	boolean	No	Enable file transfer support. Default: `true`
`video`	query	boolean	No	Enable video encoding support. Default: `true`
`mediasource_video`	query	boolean	No	Enable MediaSource API for video. Default: `true`
`notification_server_url`	query	string	No	External notification server URL for real-time notification integration. See URL format details below.
`web_notifications`	query	boolean	No	Enable browser web notifications (native OS notifications). Default: `true`
`display_notifications`	query	boolean	No	Show notifications within display UI. Default: `true`
`notification_connection_type`	query	string	No	Notification server connection type. Allowed values: `websocket`, `polling`. Default: `"websocket"`

notification_server_url format

The notification server URL follows the pattern https://{project}-{container}-n-{display}.{node}.containers.hoody.com/notification-client.js, where n replaces the display segment of the display URL.

If the parameter is not provided, the client attempts to auto-detect the notification server by transforming the current hostname pattern (replacing display with n).

Manual example: ?notification_server_url=https://67e89abc123def456789abcd-890abcdef12345678901cdef-n-6.node-us.containers.hoody.com/notification-client.js

Auto-detected from: https://67e89abc123def456789abcd-890abcdef12345678901cdef-display-6.node-us.containers.hoody.com

The notification server (port 3999) provides historical notification retrieval, real-time WebSocket notification updates, notification icons serving, and desktop notification triggering.

Request Body

This endpoint takes no request body.

Response

The endpoint returns the HTML5 client interface as text/html.

<!DOCTYPE html>
<html>
<head><title>Hoody Display Client</title></head>
<body>
  <!-- Display HTML5 client interface -->
</body>
</html>

curl -G "https://{projectId}-{containerId}-display-1.{server}.containers.hoody.com/api/v1/display/" \
  --data-urlencode "printing=true" \
  --data-urlencode "file_transfer=true" \
  --data-urlencode "video=true" \
  --data-urlencode "mediasource_video=true" \
  --data-urlencode "notification_server_url=https://{projectId}-{containerId}-n-1.{server}.containers.hoody.com/notification-client.js" \
  --data-urlencode "web_notifications=true" \
  --data-urlencode "display_notifications=true" \
  --data-urlencode "notification_connection_type=websocket"

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://{projectId}-{containerId}-display-1.{server}.containers.hoody.com', token: process.env.HOODY_TOKEN });

await client.display.accessClient({
  printing: true,
  file_transfer: true,
  video: true,
  mediasource_video: true,
  notification_server_url: 'https://{projectId}-{containerId}-n-1.{server}.containers.hoody.com/notification-client.js',
  web_notifications: true,
  display_notifications: true,
  notification_connection_type: 'websocket',
});