Delete Style of the specified ID for the Voice Character with the specified ID

A promptId of default is always rejected: the default style is the voice's synthesis baseline and removing it would make the voice unusable. That rejection's code is VALIDATION_BAD_PARAMS; tell it apart by message. To change which style is the default, use the "set as default" operation instead of deleting.

Deleting a promptId that does not exist does not return 404 — the call succeeds as a no-op. Confirm the outcome from metadata.prompts in the response rather than inferring existence from the status code.

The removed style stays in metadata.prompts with a deleted flag, so the array length does not change. The preconditions on the voice itself match adding a style: it must be self-created and not in creating / failed.

INFO

Deprecated alias: /api/tts/voice/{id}/prompt/{promptId}. See the site document "Versions and migration".

INFO

See the Errors document for the full code reference. Always use the X-Vocu-App-Request-Id response header when troubleshooting.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200Successfully deleted Style

application/json

Marked as deleted; returns the updated voice (the entry remains in metadata.prompts with a deleted flag)

Bodyapplication/json

Example

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "72a66b7e-424e-4646-a3f2-165c606ee759",
        "idForGenerate": "7210804c-606a-45c8-8cbe-25f3926cc205",
        "name": "Miu Yan",
        "status": "lora-success",
        "metadata": {
            "avatar": "https://loremflickr.com/997/1034?lock=3398916222260618",
            "description": "Writer, friend, student",
            "prompts": [
                {
                    "id": "92dba043-b13e-4dd5-90bc-acb0d53a9661",
                    "name": "Crisp",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/788124/983910-playback-z20e11.mp3",
                    "description": "Crisp emotional style"
                },
                {
                    "id": "355929d8-ea91-4d52-9fe4-9a424bc68309",
                    "name": "Flat",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/233753/039520-playback-7ebnx3.mp3",
                    "description": "Flat emotional style"
                }
            ]
        }
    }
}

🟠400Bad request

🟠401Unauthorized

🟠403Forbidden

🟠404Not found

🟠409Conflict

🟠429Rate limited

🔴500Server error

Delete Style of the specified ID for the Voice Character with the specified ID

Request

Request Code Samples

Responses