Update voice settings

curl --request PATCH \
  --url https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "voice_config.response_time_ms",
  "value": 1200
}
'

import requests

url = "https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config"

payload = {
    "key": "voice_config.response_time_ms",
    "value": 1200
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({key: 'voice_config.response_time_ms', value: 1200})
};

fetch('https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'key' => 'voice_config.response_time_ms',
    'value' => 1200
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config"

	payload := strings.NewReader("{\n  \"key\": \"voice_config.response_time_ms\",\n  \"value\": 1200\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"voice_config.response_time_ms\",\n  \"value\": 1200\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"voice_config.response_time_ms\",\n  \"value\": 1200\n}"

response = http.request(request)
puts response.read_body

{
  "concern": "voice_config",
  "shape": "blocks",
  "schema_version": "voice-config.v1",
  "revision": "<string>",
  "values": {},
  "effects": [
    {
      "key": "<string>",
      "old_value": "<unknown>",
      "value": "<unknown>",
      "reason": "<string>"
    }
  ],
  "errors": {},
  "affected_concerns": [
    {
      "concern": "<string>",
      "revision": "<string>"
    }
  ],
  "save_mode": null,
  "schema": null,
  "schema_revision": null,
  "draft": null,
  "system_prompt": "<string>"
}

Voice Agent Settings

Update voice settings

Update one voice setting per request using key and value.

Read the voice settings schema to find the available keys:

fields[].key is the exact string to send as key.
value_type and validation describe the value’s type and constraints.
For a selection field with options_ref, choose a value from option_sets[options_ref]. Send the option’s value, not its display label.

Common settings:

Setting	Key	Value
Conversation mode	`voice_config.model_mode`	`pipeline` or `realtime`
Language model	`voice_config.llm`	A value from `voice_config.llm_models`
Speech recognition model	`voice_config.stt`	A value from `voice_config.stt_models`
Speech synthesis model	`voice_config.tts`	A value from `voice_config.tts_models`
Voice	`voice_config.tts_voice`	A value from `voice_config.tts_voices`
Response delay	`voice_config.response_time_ms`	Milliseconds; see the field’s validation

For example, to select a language model (use a value from the schema):

{"key": "voice_config.llm", "value": "openai/gpt-4.1-mini"}

Model and voice choices depend on the current conversation mode and provider. After changing the mode or a model, read the schema again before choosing a related setting. Changing one setting can change related settings; they are listed in effects, and values contains the resulting configuration.

Muting the caller while the agent speaks is a prompt setting: Update prompt settings with prompts.mute_user_while_assistant_speaks.

PATCH

api

voice_agents

{id}

concerns

voice_config

Update voice settings

curl --request PATCH \
  --url https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "voice_config.response_time_ms",
  "value": 1200
}
'

import requests

url = "https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config"

payload = {
    "key": "voice_config.response_time_ms",
    "value": 1200
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({key: 'voice_config.response_time_ms', value: 1200})
};

fetch('https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'key' => 'voice_config.response_time_ms',
    'value' => 1200
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config"

	payload := strings.NewReader("{\n  \"key\": \"voice_config.response_time_ms\",\n  \"value\": 1200\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"voice_config.response_time_ms\",\n  \"value\": 1200\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.miyon.ai/api/v1/voice_agents/{id}/concerns/voice_config")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"voice_config.response_time_ms\",\n  \"value\": 1200\n}"

response = http.request(request)
puts response.read_body

{
  "concern": "voice_config",
  "shape": "blocks",
  "schema_version": "voice-config.v1",
  "revision": "<string>",
  "values": {},
  "effects": [
    {
      "key": "<string>",
      "old_value": "<unknown>",
      "value": "<unknown>",
      "reason": "<string>"
    }
  ],
  "errors": {},
  "affected_concerns": [
    {
      "concern": "<string>",
      "revision": "<string>"
    }
  ],
  "save_mode": null,
  "schema": null,
  "schema_revision": null,
  "draft": null,
  "system_prompt": "<string>"
}

Autorisierungen

Authorization

string

header

erforderlich

Scoped API token. Required scopes are listed on each operation in x-required-scopes.

Header

If-Match

string

The revision from a previous read. If the configuration changed since, nothing is saved and 409 is returned.

Pfadparameter

integer

erforderlich

ID of the voice agent.

Body

application/json

Update one setting.

key

string

erforderlich

Field key from this concern's schema.

value

any

erforderlich

New value for the selected setting. Send a value of the type the field's value_type expects.

Antwort

Updated configuration. effects lists dependent values that changed as well.

Response format for reading and updating a settings group. On 409 and 422 the same format is returned with errors filled and values/revision reflecting the unchanged current state.

concern

enum<string>

erforderlich

The settings group this response belongs to.

Verfügbare Optionen:

voice_config,

prompts,

knowledge_base

shape

string

erforderlich

Layout hint for clients that render the settings; always blocks.

Allowed value: "blocks"

schema_version

string

erforderlich

Version of the settings schema, for example voice-config.v1.

Beispiele:

"voice-config.v1"

"prompts.v4"

"knowledge_base.v2"

revision

string

erforderlich

Current revision. Send it as If-Match on voice settings writes to avoid overwriting concurrent changes.

values

object

erforderlich

Dotted field key to current value.

effects

object[]

erforderlich

Related settings that changed as a consequence of this update.

Show child attributes

errors

object

erforderlich

Problems per field key. Empty on success.

Show child attributes

affected_concerns

object[]

erforderlich

Settings groups whose revision changed.

Show child attributes

save_mode

null

Reserved; always null.

schema

null

Reserved; always null. Read the schema from the schema endpoint.

schema_revision

null

Reserved; always null.

draft

null

Reserved; always null.

system_prompt

string

Voice settings updates only. Present when the update regenerated the agent's instructions.

Get started

Voice Agents

Voice Agent Settings

Tools

Outbound Calls

Conversations

Evals

Update voice settings

Autorisierungen

Header

Pfadparameter

Body

Antwort