---
title: "Delete a preset"
method: DELETE
path: "/presets/{preset_id}"
tags: ["Presets"]
---

# Delete a preset

`DELETE /presets/{preset_id}`

## Request

- Base URL: `https://api.dyte.io/v2`
- URL: `https://api.dyte.io/v2/presets/{preset_id}`
- Auth: HTTP basic

Deletes a preset using the provided preset ID

## Path parameters

- `preset_id` string, required

## Response `200`

Success response

- object
  - `success` boolean, required: Success status of the operation
  - `data` object, required: Data returned by the operation
    - `id` string, uuid, required: ID of the preset
    - `name` string, required: Name of the preset
    - `config` object, required
      - `view_type` 'GROUP_CALL' | 'WEBINAR' | 'AUDIO_ROOM', required: Type of the meeting
      - `max_video_streams` object, required: Maximum number of streams that are visible on a device
        - `mobile` integer, required: Maximum number of streams visible on mobile devices
        - `desktop` integer, required: Maximum number of video streams visible on desktop devices
      - `max_screenshare_count` integer, required: Maximum number of screen shares that can be active at a given time
      - `media` object, required: Media configuration options. eg: Video quality
        - `audio` object: Control options for Audio quality.
          - `enable_stereo` boolean: Enable Stereo for your meetings
          - `enable_high_bitrate` boolean: Enable High Quality Audio for your meetings
        - `video` object, required: Configuration options for participant videos
          - `quality` 'hd' | 'vga' | 'qvga', required: Video quality of participants
          - `frame_rate` integer, required: Frame rate of participants' video
        - `screenshare` object, required: Configuration options for participant screen shares
          - `quality` 'hd' | 'vga' | 'qvga', required: Quality of screen share
          - `frame_rate` integer, required: Frame rate of screen share
    - `permissions` object
      - `accept_waiting_requests` boolean, required: Whether this participant can accept waiting requests
      - `can_accept_production_requests` boolean, required
      - `can_edit_display_name` boolean, required
      - `can_spotlight` boolean, required
      - `is_recorder` boolean
      - `recorder_type` 'RECORDER' | 'LIVESTREAMER' | 'NONE', required: Type of the recording peer
      - `disable_participant_audio` boolean, required
      - `disable_participant_screensharing` boolean, required
      - `disable_participant_video` boolean, required
      - `kick_participant` boolean, required
      - `pin_participant` boolean, required
      - `can_record` boolean, required
      - `can_livestream` boolean, required
      - `waiting_room_type` 'SKIP' | 'ON_PRIVILEGED_USER_ENTRY' | 'SKIP_ON_ACCEPT', required: Waiting room type
      - `plugins` object, required: Plugin permissions
        - `can_close` boolean, required: Can close plugins that are already open
        - `can_start` boolean, required: Can start plugins
        - `can_edit_config` boolean, required: Can edit plugin config
        - `config` union, required
          - string, uuid
          - object
            - `access_control` 'FULL_ACCESS' | 'VIEW_ONLY', required
            - `handles_view_only` boolean, required
      - `connected_meetings` object, required
        - `can_alter_connected_meetings` boolean, required
        - `can_switch_connected_meetings` boolean, required
        - `can_switch_to_parent_meeting` boolean, required
      - `polls` object, required: Poll permissions
        - `can_create` boolean, required: Can create polls
        - `can_vote` boolean, required: Can vote on polls
        - `can_view` boolean, required: Can view polls
      - `media` object, required: Media permissions
        - `video` object, required: Video permissions
          - `can_produce` 'ALLOWED' | 'NOT_ALLOWED' | 'CAN_REQUEST', required: Can produce video
        - `audio` object, required: Audio permissions
          - `can_produce` 'ALLOWED' | 'NOT_ALLOWED' | 'CAN_REQUEST', required: Can produce audio
        - `screenshare` object, required: Screenshare permissions
          - `can_produce` 'ALLOWED' | 'NOT_ALLOWED' | 'CAN_REQUEST', required: Can produce screen share video
      - `chat` object, required: Chat permissions
        - `public` object, required
          - `can_send` boolean, required: Can send messages in general
          - `text` boolean, required: Can send text messages
          - `files` boolean, required: Can send file messages
        - `private` object, required
          - `can_send` boolean, required
          - `can_receive` boolean, required
          - `text` boolean, required
          - `files` boolean, required
      - `hidden_participant` boolean, required: Whether this participant is visible to others or not
      - `show_participant_list` boolean, required
      - `can_change_participant_permissions` boolean, required
    - `ui` object, required
      - `design_tokens` object, required
        - `border_radius` 'rounded', required
        - `border_width` 'thin', required
        - `spacing_base` number, required
        - `theme` 'dark', required
        - `colors` object, required
          - `brand` object, required
            - `300` string, required
            - `400` string, required
            - `500` string, required
            - `600` string, required
            - `700` string, required
          - `background` object, required
            - `600` string, required
            - `700` string, required
            - `800` string, required
            - `900` string, required
            - `1000` string, required
          - `danger` string, required
          - `text` string, required
          - `text_on_brand` string, required
          - `success` string, required
          - `video_bg` string, required
          - `warning` string, required
        - `logo` string, required
      - `config_diff` object

## Changes

- **2025-04-04** (v2) `cb67ff854c71`: 1 breaking, 1 info
  - added the new path request parameter `preset_id`
  - the endpoint scheme security `Authorization` was added to the API
- **2025-04-03** (v2) `68b9e665bfcc`: 1 warning, 1 info
  - deleted the `path` request parameter `preset_id`
  - the endpoint scheme security `Authorization` was removed from the API
- **2024-11-20** (v2) `d8c5d90e84ac`: 1 breaking, 1 info
  - added the new path request parameter `preset_id`
  - the endpoint scheme security `Authorization` was added to the API
- **2024-08-09** (v2) `65ed3e73952b`: 1 info
  - added the optional property `allOf[subschema #2]/data/allOf[subschema #2: Preset]/config/media/audio` to the response with the `200` status
- **2023-10-20** (v2) `cf0c52843ea6`: 2 info
  - removed the `fhd` enum value from the `allOf[subschema #2]/data/allOf[subschema #2: Preset]/config/media/screenshare/quality` response property for the response status `200`
  - removed the `fhd` enum value from the `allOf[subschema #2]/data/allOf[subschema #2: Preset]/config/media/video/quality` response property for the response status `200`

[Operation history](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/changes/presets/:preset_id/delete.md)

---

[API](https://skmtc.dev/dyte-io/apis/dyte-rest-apis.md) - [All operations](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/revisions/f62d3edd92ae?raw)
