PATCH /accounts/{account_id}/realtime/kit/{app_id}/presets/{preset_id}

Update a preset by the provided preset ID

Servers

Path parameters

Name Type Required Description
app_id String Yes
account_id String Yes
preset_id String Yes

ID of the preset to fetch

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
name String No

Name of the preset

config Object No
config.livestream_viewer_qualities[] Array No

Livestream viewer quality levels.

config.view_type String No

Type of the meeting

Valid values:

  • "LIVESTREAM"
  • "GROUP_CALL"
  • "WEBINAR"
  • "AUDIO_ROOM"
config.media Object No

Media configuration options. eg: Video quality

config.media.video Object No

Configuration options for participant videos

config.media.video.quality String No

Video quality of participants

Valid values:

  • "vga"
  • "hd"
  • "qvga"
  • "uhd"
  • "fhd"
config.media.video.simulcast Boolean No

Enable simulcast for participant videos.

config.media.video.frame_rate Number No

Frame rate of participants' video

config.media.audio Object No

Control options for Audio quality.

config.media.audio.enable_high_bitrate Boolean No

Enable High Quality Audio for your meetings

Default value: false

config.media.audio.enable_stereo Boolean No

Enable Stereo for your meetings

Default value: false

config.media.screenshare Object No

Configuration options for participant screen shares

config.media.screenshare.quality String No

Quality of screen share

Valid values:

  • "vga"
  • "hd"
  • "qvga"
  • "uhd"
  • "fhd"
config.media.screenshare.frame_rate Number No

Frame rate of screen share

config.max_video_streams Object No

Maximum number of streams that are visible on a device

config.max_video_streams.mobile Number No

Maximum number of streams visible on mobile devices

config.max_video_streams.desktop Number No

Maximum number of video streams visible on desktop devices

config.max_screenshare_count Number No

Maximum number of screen shares that can be active at a given time

ui Object No
ui.design_tokens Object No
ui.design_tokens.border_radius String No

Valid values:

  • "sharp"
  • "rounded"
  • "extra-rounded"
  • "circular"
ui.design_tokens.logo String No
ui.design_tokens.font_family String No
ui.design_tokens.spacing_base Number No

Default value: 4

ui.design_tokens.border_width String No

Valid values:

  • "fat"
  • "none"
  • "thin"
ui.design_tokens.colors Object No
ui.design_tokens.colors.text_on_brand String No

Default value: "#EEEEEE"

ui.design_tokens.colors.text String No

Default value: "#EEEEEE"

ui.design_tokens.colors.warning String No

Default value: "#FFCD07"

ui.design_tokens.colors.brand Object No
ui.design_tokens.colors.brand.300 String No

Default value: "#844d1c"

ui.design_tokens.colors.brand.400 String No

Default value: "#9d5b22"

ui.design_tokens.colors.brand.500 String No

Default value: "#b56927"

ui.design_tokens.colors.brand.600 String No

Default value: "#d37c30"

ui.design_tokens.colors.brand.700 String No

Default value: "#d9904f"

ui.design_tokens.colors.danger String No

Default value: "#FF2D2D"

ui.design_tokens.colors.background Object No
ui.design_tokens.colors.background.1000 String No

Default value: "#141414"

ui.design_tokens.colors.background.600 String No

Default value: "#222222"

ui.design_tokens.colors.background.700 String No

Default value: "#1f1f1f"

ui.design_tokens.colors.background.800 String No

Default value: "#1b1b1b"

ui.design_tokens.colors.background.900 String No

Default value: "#181818"

ui.design_tokens.colors.success String No

Default value: "#62A504"

ui.design_tokens.colors.video_bg String No

Default value: "#191919"

ui.design_tokens.google_font String No
ui.design_tokens.theme String No

Valid values:

  • "darkest"
  • "dark"
  • "light"
permissions Object No
permissions.stage_access String No

Valid values:

  • "ALLOWED"
  • "CAN_REQUEST"
  • "NOT_ALLOWED"
permissions.hidden_participant Boolean No

Whether this participant is visible to others or not

permissions.kick_participant Boolean No
permissions.transcription_enabled Boolean No
permissions.can_change_participant_permissions Boolean No
permissions.can_accept_production_requests Boolean No
permissions.can_livestream Boolean No
permissions.waiting_room_type String No

Waiting room type

Valid values:

  • "SKIP_ON_ACCEPT"
  • "SKIP"
  • "ON_PRIVILEGED_USER_ENTRY"
permissions.disable_participant_audio Boolean No
permissions.disable_participant_video Boolean No
permissions.pin_participant Boolean No
permissions.polls Object No

Poll permissions

permissions.polls.can_vote Boolean No

Can vote on polls

permissions.polls.can_create Boolean No

Can create polls

permissions.polls.can_view Boolean No

Can view polls

permissions.can_record Boolean No
permissions.stage_enabled Boolean No
permissions.accept_waiting_requests Boolean No

Whether this participant can accept waiting requests

permissions.show_participant_list Boolean No
permissions.chat Object No
permissions.chat.public Object No
permissions.chat.public.files Boolean No

Can send file messages

permissions.chat.public.text Boolean No

Can send text messages

permissions.chat.public.can_send Boolean No

Can send messages in general

permissions.chat.private Object No
permissions.chat.private.files Boolean No
permissions.chat.private.text Boolean No
permissions.chat.private.can_receive Boolean No
permissions.chat.private.can_send Boolean No
permissions.accept_stage_requests Boolean No
permissions.is_recorder Boolean No

Default value: false

permissions.recorder_type String No

Type of the recording peer

Valid values:

  • "RECORDER"
  • "LIVESTREAMER"
  • "NONE"

Default value: "NONE"

permissions.connected_meetings Object No
permissions.connected_meetings.can_switch_to_parent_meeting Boolean No
permissions.connected_meetings.can_alter_connected_meetings Boolean No
permissions.connected_meetings.can_switch_connected_meetings Boolean No
permissions.can_edit_display_name Boolean No
permissions.can_spotlight Boolean No
permissions.plugins Object No

Plugin permissions

permissions.plugins.can_start Boolean No

Can start plugins

permissions.plugins.can_close Boolean No

Can close plugins that are already open

permissions.plugins.config Object No

Plugin configuration keyed by plugin UUID.

permissions.plugins.can_edit_config Boolean No

Can edit plugin config

permissions.media Object No

Media permissions

permissions.media.video Object No

Video permissions

permissions.media.video.can_produce String No

Can produce video

Valid values:

  • "ALLOWED"
  • "CAN_REQUEST"
  • "NOT_ALLOWED"
permissions.media.audio Object No

Audio permissions

permissions.media.audio.can_produce String No

Can produce audio

Valid values:

  • "ALLOWED"
  • "CAN_REQUEST"
  • "NOT_ALLOWED"
permissions.media.screenshare Object No

Screenshare permissions

permissions.media.screenshare.can_produce String No

Can produce screen share video

Valid values:

  • "ALLOWED"
  • "CAN_REQUEST"
  • "NOT_ALLOWED"
permissions.disable_participant_screensharing Boolean No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.