[BUG/ISSUE] 400 Bad Request: Incorrect structure for voice.experimentalControls.emotion

Dear VAPI Support Team,

I am experiencing an issue when attempting to use the experimentalControls to set the voice emotion in the assistantOverrides of a call request. The API consistently returns a 400 Bad Request error.

  1. Error Message
    The response I receive is:
JSON

{
"message": [
"assistantOverrides.voice.experimentalControls.Only one emotion intensity level per emotion type is allowed"
],
"error": "Bad Request",
"statusCode": 400
}
  1. Request Payload Examples
    A. Payload from the cURL Request (as seen in the screenshot):
JSON

...
"experimentalControls": {
"emotion": "positivity:highest"
}
...
B. Payload from my internal JSON structure:

JSON

...
"experimentalControls": {
"emotion": "surprise:high"
}
...
  1. Issue Description
    I believe the API endpoint is expecting a different structure for the emotion key within experimentalControls. I have tried to pass the emotion and intensity as a string (e.g., "positivity:highest"), which seems to be the cause of the error.
Could you please confirm the correct and expected JSON structure for setting the voice emotion and its intensity in the assistantOverrides.voice.experimentalControls object?

For example, is the correct structure:

JSON

"experimentalControls": {
"emotion": {
"positivity": "highest"
}
}
or something else?

Thank you for your assistance in clarifying the correct payload format.

Best regards,
Snimka_obrazovky_2025-10-29_o_12.17.31.png
Was this page helpful?