---
title: "Reset voice settings"
method: POST
path: "/organization/voices/{id}/reset_settings"
tags: ["Voices"]
---

# Reset voice settings

`POST /organization/voices/{id}/reset_settings`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/organization/voices/{id}/reset_settings`
- Auth: API key in header `X-Api-Key`

Deletes the publisher-specific voice settings, falling back to the voice global defaults.

## Response `200`

successful

- VoiceModel
  - `id` integer: Unique identifier for the object
  - `name` string: The name of the voice
  - `type` 'premade' | 'instant' | 'professional' | 'generated': The type of the voice
  - `status` 'draft' | 'recording' | 'processing' | 'review' | 'enabled' | 'deprecated' | 'disabled' | 'unavailable': The status of the voice
  - `preview_statuses` 'processing' | 'processed': The preview status of the voice for its primary language
  - `speaker` object, nullable: The speaker of the voice
    - `id` integer: Unique identifier for the object
    - `first_name` string: The first name of the speaker
    - `last_name` string: The last name of the speaker
    - `image_url` string, nullable: The image URL of the speaker
    - `created` string, date-time: Time at which the object was created (ISO 8601)
    - `updated` string, date-time: Time at which the object was updated (ISO 8601)
  - `script_ids` integer[]: The script IDs associated with the voice
  - `speaking_rate` integer: The speaking rate of the voice
  - `multilingual_mode` boolean
  - `expressiveness` number, nullable
  - `use_speaker_boost` boolean, nullable
  - `similarity_boost` number, nullable
  - `style` number, nullable
  - `clone_strength` number, nullable: Only applied to ElevenLabs professional voice clones on eleven_v4 / eleven_v4_turbo
  - `languages` object[]: The languages supported by the voice
    - `code` string: The ISO 639-1 code of the language
    - `name` string: The name of the language
    - `accent` string, nullable: The accent of the language
    - `preview_url` string, nullable: The preview URL of the language
  - `cloning_consent` string, nullable: The cloning consent URL for instant and professional voices
  - `clone_errors` object[]: An array of voice cloning errors in the standard error format
  - `created` string, date-time: Time at which the object was created (ISO 8601)
  - `updated` string, date-time: Time at which the object was updated (ISO 8601)
  - `logo_pattern` integer, nullable: Logo pattern number
  - `logo_color` 'red' | 'green' | 'blue' | 'purple' | 'gray' | 'pink' | 'cyan', nullable: Logo pattern color
  - `gender` 'male' | 'female' | 'neutral', nullable: The gender of the voice
  - `language` string: The language of the voice
  - `secondary_languages` string[]: The secondary languages of the voice
  - `service` string: The source of the voice
  - `model_id` string, nullable
  - `expected_model_ids` string[], nullable: Model IDs the voice will be available for once cloning finishes. Only present while the voice is recording or processing
  - `preview_url` string, nullable: The preview URL of the voice
  - `premium` boolean: Whether the voice is premium or not
  - `exclusive` boolean: Whether the voice is exclusive or not
  - `custom` boolean: The custom flag of the voice
  - `additional` boolean
  - `pauses_supported` boolean
  - `clone_strength_supported` boolean: Whether the clone_strength voice setting is applied for this voice

## Other responses

- `401`: Invalid authentication token

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/organization/voices/:id/reset_settings/post.md)

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) - [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/revisions/994b9853e685?raw)