Save Model Configuration V2

PUT /api/v1/organizations/model-configurations/v2 — request parameters and responses from the Menace Voice API schema.

2 min read

put/api/v1/organizations/model-configurations/v2

Request example

curl --request PUT \
  --url https://voice.menaceui.com/api/v1/organizations/model-configurations/v2 \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "version": 2,
  "mode": "dograh",
  "dograh": {
    "api_key": "<string>",
    "voice": "default",
    "speed": 1,
    "language": "multi"
  },
  "byok": {
    "mode": "pipeline",
    "pipeline": {
      "llm": {
        "provider": "openai",
        "api_key": "<string>",
        "model": "gpt-4.1",
        "base_url": "https://api.openai.com/v1"
      },
      "tts": {
        "provider": "deepgram",
        "api_key": "<string>",
        "voice": "aura-2-helena-en"
      },
      "stt": {
        "provider": "deepgram",
        "api_key": "<string>",
        "model": "nova-3-general",
        "language": "multi"
      },
      "embeddings": {
        "provider": "openai",
        "api_key": "<string>",
        "model": "text-embedding-3-small"
      }
    },
    "realtime": {
      "realtime": {
        "provider": "openai_realtime",
        "api_key": "<string>",
        "model": "gpt-realtime-2",
        "voice": "alloy",
        "language": "en"
      },
      "llm": {
        "provider": "openai",
        "api_key": "<string>",
        "model": "gpt-4.1",
        "base_url": "https://api.openai.com/v1"
      },
      "embeddings": {
        "provider": "openai",
        "api_key": "<string>",
        "model": "text-embedding-3-small"
      }
    }
  }
}'

Response

{
  "configuration": {},
  "effective_configuration": {},
  "source": "organization_v2"
}

put/api/v1/organizations/model-configurations/v2

See authentication for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

versionenum<integer>#

Default: 2

Options:2

modeenum<string>required#

Options:dograhbyok

dograhobject · null#

Show child attributes

Any of

api_keystringrequired#

voicestring#

Default: "default"

speednumber#

Default: 1

Range: 0.5–2

languagestring#

Default: "multi"

byokobject · null#

Show child attributes

Any of

modeenum<string>required#

Options:pipelinerealtime

pipelineobject · null#

Show child attributes

realtimeobject · null#

Show child attributes

Responses

application/json

Successful Response

configurationobject · nullrequired#

Show child attributes

Any of

effective_configurationobjectrequired#

sourceenum<string>required#

Options:organization_v2legacy_user_v1empty

Get Model Configuration V2 Get Model Configuration Pricing