voice

Set or clear one number's agent voice

Choose the Cartesia voice the conversational agent speaks in for calls placed from one of your DIDs. Send a canonical UUID to set it, or null to clear it and return the number to the platform default voice. voice_id is REQUIRED in the body: omitting the key is a 400, not a clear, so a mistyped field name can never silently reset a number. The id is validated for SHAPE only, we do not keep a list of valid Cartesia voice ids, so any well-formed UUID is accepted and it is yours to confirm that it names a voice on your account. A malformed id is a 400 that names the accepted form; it is never a silent no-op. from_number must be a Telnyx DID owned by your organization, else 403. Any field other than from_number and voice_id is a 400 that names the right route: the agent SPOKEN LINES live at PATCH /voice/bridge/numbers/instructions, and sending "instructions" here used to be silently discarded. Requires the voice:bridge scope.

patch/voice/bridge/numbers

Request

Base URL: https://corebee.ai/api/v1
URL: https://corebee.ai/api/v1/voice/bridge/numbers
Auth: HTTP bearer

Request body

from_numberstring required

E.164 DID owned by your organization. 403 if it is not.

voice_idstring nullable required

Canonical Cartesia voice UUID, or null to clear the choice and use the platform default voice. REQUIRED: omitting the key is a 400, never a clear. Validated for shape only, any well-formed UUID is accepted, so confirm it names a voice on your Cartesia account.

Example request

{
  "from_number": "+17635550123",
  "voice_id": "5c42302c-194b-4d0c-ba1a-8cb485c84ab9"
}

Response

Updated

Example response

{
  "data": {
    "from_number": "+17635550123",
    "voice_id": "5c42302c-194b-4d0c-ba1a-8cb485c84ab9"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.