Update a preset

This endpoint updates an existing voice settings preset. You can only update your own custom presets (not default/public presets).

Authorization

• Only the preset owner can update their presets
• Default/public presets cannot be modified
• Returns 403 error if you attempt to update a preset you don't own

HTTP Request

PATCH https://app.resemble.ai/api/v2/voice_settings_presets/:uuid

URL Parameters	Type	Description
uuid	string	UUID of the preset to update

Request Body

All parameters are optional. Only provided parameters will be updated; others remain unchanged.

Parameter	Type	Required	Validation	Description
name	string	No	Max 30 characters	Preset name (must be unique)
pace	number	No	0.2 - 2.0	Speech pace/speed
temperature	number	No	0.1 - 5.0	Voice variation
pitch	number	No	-10 to 10	Voice pitch adjustment
useHd	boolean	No	true/false	Use HD quality
exaggeration	number	No	0.0 - 1.0	Emotional exaggeration
description	string	No	Max 1000 characters	Voice style prompt

HTTP Response

Success Response (200)

{
    "success": true,
    "data": {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Updated Name",
        "settings": {
            "pace": 1.5,
            "temperature": 1.1,
            "pitch": 0.5,
            "useHd": false,
            "exaggeration": 0.7,
            "description": "Updated description"
        },
        "is_public": false,
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-02T00:00:00Z"
    },
    "message": "Preset updated successfully"
}

Error Response (403 Forbidden)

{
    "success": false,
    "message": "You are not authorized to perform this action"
}

Error Response (404 Not Found)

{
    "success": false,
    "message": "Preset not found"
}

Error Response (422 Validation Error)

{
    "success": false,
    "errors": ["Name must be unique", "pace must be between 0.2 and 2.0"],
    "message": "Failed to update preset"
}

Notes

• Partial updates are supported - you only need to include the fields you want to change
• The updated_at timestamp will be automatically updated
• Cannot update is_public flag or other system-managed fields

Examples

NodeJS

1 Coming soon...

Try it out

API Key:

JSON Body:

{ "name": "Updated Name", "pace": 1.5 }