Read a hosted agent's safe STT, model, and TTS configuration

The target agent authorizes the tenant boundary. Returns selected/resolved STT, model, and TTS catalog metadata plus validation warnings, cost, latency, prompt, and tuning configuration. Platform-managed selections use the catalog's managed component estimate; a BYOK component selected on PATCH through an existing component credential ID has no Skysay component charge. Credential binding IDs, plaintext, ciphertext, nonce, fingerprints, and provider secrets are never returned. This GET is a pure read: it makes no provider call, validation probe, compilation, repair, lazy creation, or write.

get/v1/agents/{agent_id}/voice-stack

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/agents/{agent_id}/voice-stack
  • Auth: none declared

Path parameters

agent_idstring required

Response

Safe voice-stack projection

agent_idstring required
costobject required
first_messagestring
languagestring required
latencyobject required
modelobject required
organization_idstring required
project_idstring required
selectableboolean required
system_promptstring
transcriberobject required
voiceobject required

The stored TTS selection as the agent catalog projects it, including delivery_control (voice_settings, instruction, speed or unsupported): whether a voice_polish.delivery profile changes this voice's audio, and delivery_profiles: the exact value each profile resolves to on this engine (empty for unsupported), both read from the packaged delivery table.

voice_frontend'cascade' | 'gpt_live' | 'gemini_live'

The conversation engine; cascade is the default. Always present on GET; omitted on older rows means cascade. Whether this engine has a language axis is declared in the agent-catalog conversation_engines block (has_language_axis).

voice_labelstring
warningsstring[] required

Changes

No recorded changes to this operation across all 2 revisions of this API.