Configure Display
configure_displayUpdates display settings: rename (name), lock or unlock content changes (locked), privacy mode for share links (privacy_mode), embed-origin allowlist (origins), hardware permissions (camera, microphone, geolocation), preferred language, mouse cursor, badge overlay and watermark position. Only the fields you pass are changed; online displays apply changes immediately. Use for any display setting change. Not for sending content (send_html, send_url) or deleting (delete_display). Requires admin scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New display name (rename). | |
| locked | No | true blocks content changes until unlocked; false unlocks. | |
| origins | No | Embed-origin allowlist for Public displays; [] allows all origins. | |
| whitelist | No | Domain whitelist for whitelist-only mode. | |
| display_id | Yes | 8-character display profile ID, e.g. 'ABCD1234'. | |
| access_token | No | Optional bearer token; prefer session_request_id. | |
| allow_camera | No | ||
| privacy_mode | No | Private caps share-link TTL at 1 hour; Public (signage mode) allows 24 hours. | |
| allow_microphone | No | ||
| strict_whitelist | No | true: the display whitelist replaces the org whitelist instead of extending it. | |
| allow_geolocation | No | ||
| connectivity_mode | No | Per-display network mode override. | |
| show_mouse_cursor | No | ||
| preferred_language | No | ||
| session_request_id | No | Session handle from create_auth_session; pass it on every authenticated call. | |
| show_badge_overlay | No | ||
| watermark_position | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| name | No | ||
| allowCamera | No | ||
| allowMicrophone | No | ||
| changedSettings | No | ||
| showMouseCursor | No | ||
| allowGeolocation | No | ||
| showBadgeOverlay | No | ||
| effectiveLanguage | No | ||
| preferredLanguage | No | ||
| watermarkPosition | No | ||
| appliedToLiveDisplay | No |