Update a splitter configuration (diff mode)

Update a splitter configuration. At least one of name and config must be provided, otherwise VALIDATION_MISSING_FIELD.

config is deep-merged in diff mode, not wholesale replaced

Only keys that are passed are updated; omitted keys stay as they were.

When both sides are non-array objects, merge recursively; otherwise overwrite (arrays are overwritten as a whole).

Explicitly setting a key's value to null deletes that key.

After the merge, the merged result is re-run through the same validation as create; failure rolls the whole update back as TTS_SPLITTER_INVALID.
That means a seemingly local deletion (for example deleting the last placeholder with no fallbackConfig) can also make the entire configuration invalid and be rejected.

Note: this endpoint uses POST, not PUT/PATCH.

INFO

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

Example

{
    "name": "string",
    "config": {
        "splitterMarks": [
            "st"
        ],
        "lookupTable": {
            "property1": "string",
            "property2": "string"
        },
        "fallbackConfig": {
            "voiceId": "string"
        },
        "property1": "string",
        "property2": "string"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Updated. Returns the full configuration after the merge.

Bodyapplication/json

Example

{
    "status": 200,
    "data": {
        "id": "3f2a1b6c-8d4e-4f27-9a10-5c7e2d81b043",
        "name": "Three-speaker dialogue configuration",
        "config": {
            "<CharacterA>": {
                "voiceId": "9d7f2e14-5b30-4a6c-8e91-c2340af6b7d5",
                "speechRate": 1.2
            },
            "<CharacterC>": {
                "voiceId": "5e6a90b3-1c47-4d82-a0f5-38b7ce2419d6",
                "speechRate": 1
            },
            "[faster_speech:1.2]": {
                "speechRate": 1.2
            }
        },
        "createdAt": "2026-08-12T09:31:44.000Z",
        "updatedAt": "2026-08-19T14:22:03.000Z"
    }
}

🟠400Bad request

🟠401Unauthorized

🟠404Not found

🟠429Rate limited

🔴500Server error