Update an assistant

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const inferenceEmbedding = await client.ai.assistants.update('assistant_id');

console.log(inferenceEmbedding.id);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
inference_embedding = client.ai.assistants.update(
    assistant_id="assistant_id",
)
print(inference_embedding.id)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	inferenceEmbedding, err := client.AI.Assistants.Update(
		context.TODO(),
		"assistant_id",
		telnyx.AIAssistantUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", inferenceEmbedding.ID)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.ai.assistants.AssistantUpdateParams;
import com.telnyx.sdk.models.ai.assistants.InferenceEmbedding;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        InferenceEmbedding inferenceEmbedding = client.ai().assistants().update("assistant_id");
    }
}

require "telnyx"

telnyx = Telnyx::Client.new(api_key: "My API Key")

inference_embedding = telnyx.ai.assistants.update("assistant_id")

puts(inference_embedding)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\AI\Assistants\EnabledFeatures;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $inferenceEmbedding = $client->ai->assistants->update(
    'assistant_id',
    conversationFlow: [
      'nodes' => [
        [
          'id' => 'n_intake',
          'instructions' => 'Greet the caller and ask what they\'re calling about.',
          'externalLlm' => [
            'baseURL' => 'base_url',
            'model' => 'model',
            'authenticationMethod' => 'token',
            'certificateRef' => 'certificate_ref',
            'forwardMetadata' => true,
            'llmAPIKeyRef' => 'llm_api_key_ref',
            'tokenRetrievalURL' => 'token_retrieval_url',
          ],
          'instructionsMode' => 'replace',
          'llmAPIKeyRef' => 'my-key-ref',
          'model' => 'moonshotai/Kimi-K2.6',
          'name' => 'Intake',
          'position' => ['x' => 120, 'y' => 80],
          'sharedToolIDs' => ['tool-faq-kb'],
          'toolsMode' => 'replace',
          'transcription' => [
            'apiKeyRef' => 'api_key_ref',
            'language' => 'language',
            'model' => 'deepgram/flux',
            'region' => 'region',
            'settings' => [
              'eagerEotThreshold' => 0.3,
              'enableEndpointDetection' => true,
              'endOfTurnConfidenceThreshold' => 0,
              'eotThreshold' => 0.5,
              'eotTimeoutMs' => 500,
              'interimResults' => true,
              'keyterm' => 'keyterm',
              'maxEndpointDelayMs' => 500,
              'maxTurnSilence' => 100,
              'minTurnSilence' => 100,
              'numerals' => true,
              'smartFormat' => true,
            ],
          ],
          'type' => 'prompt',
          'voiceSettings' => [
            'voice' => 'voice',
            'apiKeyRef' => 'api_key_ref',
            'backgroundAudio' => [
              'type' => 'predefined_media',
              'value' => 'silence',
              'volume' => 0.1,
            ],
            'expressiveMode' => true,
            'languageBoost' => 'auto',
            'similarityBoost' => 0,
            'speed' => 0,
            'style' => 0,
            'temperature' => 0,
            'useSpeakerBoost' => true,
            'voiceSpeed' => 0,
          ],
        ],
        [
          'id' => 'n_billing',
          'instructions' => 'Focus on billing questions. Look up the caller\'s latest invoice with the billing tool before answering.',
          'externalLlm' => [
            'baseURL' => 'base_url',
            'model' => 'model',
            'authenticationMethod' => 'token',
            'certificateRef' => 'certificate_ref',
            'forwardMetadata' => true,
            'llmAPIKeyRef' => 'llm_api_key_ref',
            'tokenRetrievalURL' => 'token_retrieval_url',
          ],
          'instructionsMode' => 'append',
          'llmAPIKeyRef' => 'my-key-ref',
          'model' => 'moonshotai/Kimi-K2.6',
          'name' => 'Billing',
          'position' => ['x' => 420, 'y' => 80],
          'sharedToolIDs' => ['tool-billing-lookup'],
          'toolsMode' => 'append',
          'transcription' => [
            'apiKeyRef' => 'api_key_ref',
            'language' => 'language',
            'model' => 'deepgram/flux',
            'region' => 'region',
            'settings' => [
              'eagerEotThreshold' => 0.3,
              'enableEndpointDetection' => true,
              'endOfTurnConfidenceThreshold' => 0,
              'eotThreshold' => 0.5,
              'eotTimeoutMs' => 500,
              'interimResults' => true,
              'keyterm' => 'keyterm',
              'maxEndpointDelayMs' => 500,
              'maxTurnSilence' => 100,
              'minTurnSilence' => 100,
              'numerals' => true,
              'smartFormat' => true,
            ],
          ],
          'type' => 'prompt',
          'voiceSettings' => [
            'voice' => 'voice',
            'apiKeyRef' => 'api_key_ref',
            'backgroundAudio' => [
              'type' => 'predefined_media',
              'value' => 'silence',
              'volume' => 0.1,
            ],
            'expressiveMode' => true,
            'languageBoost' => 'auto',
            'similarityBoost' => 0,
            'speed' => 0,
            'style' => 0,
            'temperature' => 0,
            'useSpeakerBoost' => true,
            'voiceSpeed' => 0,
          ],
        ],
      ],
      'startNodeID' => 'n_intake',
      'edges' => [
        [
          'id' => 'e_intake_to_billing',
          'condition' => [
            'prompt' => 'The caller is asking about a bill or charge.',
            'type' => 'llm',
          ],
          'startNodeID' => 'n_intake',
          'target' => ['nodeID' => 'n_billing', 'type' => 'node'],
        ],
        [
          'id' => 'e_intake_to_escalation_assistant',
          'condition' => [
            'prompt' => 'The caller has explicitly asked for a human.',
            'type' => 'llm',
          ],
          'startNodeID' => 'n_intake',
          'target' => [
            'assistantID' => 'assistant-human-handoff',
            'type' => 'assistant',
            'position' => ['x' => 600, 'y' => 80],
            'voiceMode' => 'distinct',
          ],
        ],
      ],
    ],
    description: 'description',
    dynamicVariables: ['foo' => 'bar'],
    dynamicVariablesWebhookTimeoutMs: 1,
    dynamicVariablesWebhookURL: 'dynamic_variables_webhook_url',
    enabledFeatures: [EnabledFeatures::TELEPHONY],
    externalLlm: [
      'baseURL' => 'base_url',
      'model' => 'model',
      'authenticationMethod' => 'token',
      'certificateRef' => 'certificate_ref',
      'forwardMetadata' => true,
      'llmAPIKeyRef' => 'llm_api_key_ref',
      'tokenRetrievalURL' => 'token_retrieval_url',
    ],
    fallbackConfig: [
      'externalLlm' => [
        'baseURL' => 'base_url',
        'model' => 'model',
        'authenticationMethod' => 'token',
        'certificateRef' => 'certificate_ref',
        'forwardMetadata' => true,
        'llmAPIKeyRef' => 'llm_api_key_ref',
        'tokenRetrievalURL' => 'token_retrieval_url',
      ],
      'llmAPIKeyRef' => 'llm_api_key_ref',
      'model' => 'model',
    ],
    greeting: 'greeting',
    insightSettings: ['insightGroupID' => 'insight_group_id'],
    instructions: 'instructions',
    integrations: [
      ['integrationID' => 'integration_id', 'allowedList' => ['string']]
    ],
    interruptionSettings: [
      'disableGreetingInterruption' => true,
      'enable' => true,
      'startSpeakingPlan' => [
        'transcriptionEndpointingPlan' => [
          'onNoPunctuationSeconds' => 0,
          'onNumberSeconds' => 0,
          'onPunctuationSeconds' => 0,
        ],
        'waitSeconds' => 0,
      ],
    ],
    llmAPIKeyRef: 'llm_api_key_ref',
    mcpServers: [['id' => 'id', 'allowedTools' => ['string']]],
    messagingSettings: [
      'conversationInactivityMinutes' => 1,
      'defaultMessagingProfileID' => 'default_messaging_profile_id',
      'deliveryStatusWebhookURL' => 'delivery_status_webhook_url',
    ],
    model: 'model',
    name: 'name',
    observabilitySettings: [
      'host' => 'host',
      'promptLabel' => 'prompt_label',
      'promptName' => 'prompt_name',
      'promptSync' => 'enabled',
      'promptVersion' => 1,
      'publicKeyRef' => 'public_key_ref',
      'secretKeyRef' => 'secret_key_ref',
      'status' => 'enabled',
    ],
    postConversationSettings: ['enabled' => true],
    privacySettings: ['dataRetention' => true],
    promoteToMain: true,
    tags: ['string'],
    telephonySettings: [
      'defaultTexmlAppID' => 'default_texml_app_id',
      'noiseSuppression' => 'krisp',
      'noiseSuppressionConfig' => [
        'attenuationLimit' => 0, 'mode' => 'advanced'
      ],
      'recordingSettings' => [
        'channels' => 'single',
        'enabled' => true,
        'format' => 'wav',
        'stopOnConversationEnd' => true,
      ],
      'supportsUnauthenticatedWebCalls' => true,
      'timeLimitSecs' => 30,
      'userIdleReplySecs' => 0,
      'userIdleTimeoutSecs' => 10,
      'voicemailDetection' => [
        'onVoicemailDetected' => [
          'action' => 'stop_assistant',
          'voicemailMessage' => [
            'message' => 'message', 'prompt' => 'prompt', 'type' => 'prompt'
          ],
        ],
      ],
    ],
    toolIDs: ['string'],
    tools: [
      [
        'type' => 'webhook',
        'webhook' => [
          'description' => 'description',
          'name' => 'name',
          'url' => 'https://example.com/api/v1/function',
          'async' => true,
          'asyncTimeoutMs' => 1,
          'bodyParameters' => [
            'properties' => ['age' => 'bar', 'location' => 'bar'],
            'required' => ['age', 'location'],
            'type' => 'object',
          ],
          'headers' => [['name' => 'name', 'value' => 'value']],
          'method' => 'GET',
          'pathParameters' => [
            'properties' => ['id' => 'bar'],
            'required' => ['id'],
            'type' => 'object',
          ],
          'queryParameters' => [
            'properties' => ['page' => 'bar'],
            'required' => ['page'],
            'type' => 'object',
          ],
          'storeFieldsAsVariables' => [['name' => 'x', 'valuePath' => 'x']],
          'timeoutMs' => 500,
        ],
      ],
    ],
    transcription: [
      'apiKeyRef' => 'api_key_ref',
      'language' => 'language',
      'model' => 'deepgram/flux',
      'region' => 'region',
      'settings' => [
        'eagerEotThreshold' => 0.3,
        'enableEndpointDetection' => true,
        'endOfTurnConfidenceThreshold' => 0,
        'eotThreshold' => 0.5,
        'eotTimeoutMs' => 500,
        'interimResults' => true,
        'keyterm' => 'keyterm',
        'maxEndpointDelayMs' => 500,
        'maxTurnSilence' => 100,
        'minTurnSilence' => 100,
        'numerals' => true,
        'smartFormat' => true,
      ],
    ],
    versionName: 'version_name',
    voiceSettings: [
      'voice' => 'voice',
      'apiKeyRef' => 'api_key_ref',
      'backgroundAudio' => [
        'type' => 'predefined_media', 'value' => 'silence', 'volume' => 0.1
      ],
      'expressiveMode' => true,
      'languageBoost' => 'auto',
      'similarityBoost' => 0,
      'speed' => 0,
      'style' => 0,
      'temperature' => 0,
      'useSpeakerBoost' => true,
      'voiceSpeed' => 0,
    ],
    widgetSettings: [
      'agentThinkingText' => 'agent_thinking_text',
      'audioVisualizerConfig' => ['color' => 'verdant', 'preset' => 'preset'],
      'defaultState' => 'expanded',
      'giveFeedbackURL' => 'give_feedback_url',
      'logoIconURL' => 'logo_icon_url',
      'position' => 'fixed',
      'reportIssueURL' => 'report_issue_url',
      'speakToInterruptText' => 'speak_to_interrupt_text',
      'startCallText' => 'start_call_text',
      'theme' => 'light',
      'viewHistoryURL' => 'view_history_url',
    ],
  );

  var_dump($inferenceEmbedding);
} catch (APIException $e) {
  echo $e->getMessage();
}

telnyx ai:assistants update \
  --api-key 'My API Key' \
  --assistant-id assistant_id

curl --request POST \
  --url https://api.telnyx.com/v2/ai/assistants/{assistant_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "<string>",
  "model": "<string>",
  "instructions": "<string>",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "<string>",
        "description": "<string>",
        "parameters": {}
      }
    }
  ],
  "mcp_servers": [],
  "a2a_agents": [
    {
      "name": "billing_agent",
      "url": "https://agents.example.com",
      "headers": [
        {
          "name": "X-Api-Key",
          "value": "{{#integration_secret}}my_agent_api_key{{/integration_secret}}"
        }
      ],
      "async": false,
      "timeout_ms": 30000,
      "poll_interval_ms": 500,
      "messages": [
        {
          "type": "request_start",
          "content": "<string>",
          "timing_ms": 60050
        }
      ]
    }
  ],
  "tool_ids": [
    "<string>"
  ],
  "description": "<string>",
  "greeting": "<string>",
  "llm_api_key_ref": "<string>",
  "fallback_config": {
    "model": "<string>",
    "llm_api_key_ref": "<string>"
  },
  "transcription": {
    "language": "<string>",
    "api_key_ref": "<string>",
    "region": "<string>",
    "settings": {
      "smart_format": true,
      "numerals": true,
      "eot_threshold": 0.8,
      "eot_timeout_ms": 5000,
      "eager_eot_threshold": 0.8,
      "keyterm": "<string>",
      "end_of_turn_confidence_threshold": 0.4,
      "min_turn_silence": 400,
      "max_turn_silence": 1280,
      "interim_results": false,
      "enable_endpoint_detection": false,
      "max_endpoint_delay_ms": 1750,
      "context": "<string>",
      "language_hints": [
        "<string>"
      ]
    }
  },
  "telephony_settings": {
    "default_texml_app_id": "<string>",
    "supports_unauthenticated_web_calls": true,
    "noise_suppression_config": {
      "attenuation_limit": 100,
      "mode": "advanced",
      "family": "quail",
      "enhancement_level": 0.8
    },
    "time_limit_secs": 1800,
    "user_idle_timeout_secs": 7205,
    "user_idle_reply_secs": 10,
    "fallback_destination": "<string>",
    "send_message_history_updates": true,
    "voicemail_detection": {
      "on_voicemail_detected": {
        "voicemail_message": {
          "prompt": "<string>",
          "message": "<string>"
        }
      }
    },
    "disable_dtmf": false,
    "recording_settings": {
      "enabled": true,
      "channels": "dual",
      "format": "mp3",
      "stop_on_conversation_end": false
    }
  },
  "messaging_settings": {
    "default_messaging_profile_id": "<string>",
    "delivery_status_webhook_url": "<string>",
    "conversation_inactivity_minutes": 5000000
  },
  "enabled_features": [],
  "insight_settings": {
    "insight_group_id": "<string>"
  },
  "privacy_settings": {
    "data_retention": true,
    "in_transit_data_locality": false
  },
  "dynamic_variables_webhook_url": "<string>",
  "dynamic_variables_webhook_timeout_ms": 1500,
  "dynamic_variables": {},
  "widget_settings": {
    "audio_visualizer_config": {
      "preset": "<string>"
    },
    "start_call_text": "<string>",
    "view_history_url": "<string>",
    "report_issue_url": "<string>",
    "give_feedback_url": "<string>",
    "agent_thinking_text": "<string>",
    "speak_to_interrupt_text": "<string>",
    "logo_icon_url": "<string>"
  },
  "interruption_settings": {
    "enable": true,
    "disable_greeting_interruption": true,
    "start_speaking_plan": {
      "wait_seconds": 0.4,
      "transcription_endpointing_plan": {
        "on_punctuation_seconds": 0.1,
        "on_no_punctuation_seconds": 1.5,
        "on_number_seconds": 0.5
      }
    },
    "interrupt_prediction_threshold": 0
  },
  "integrations": [],
  "observability_settings": {
    "status": "disabled",
    "secret_key_ref": "<string>",
    "public_key_ref": "<string>",
    "host": "<string>",
    "prompt_name": "<string>",
    "prompt_version": 2,
    "prompt_label": "<string>",
    "prompt_sync": "disabled"
  },
  "tags": [],
  "version_name": "New assistant",
  "post_conversation_settings": {
    "enabled": false
  },
  "delegation_settings": {
    "enabled": true,
    "mode": "telnyx",
    "model": "<string>",
    "llm_api_key_ref": "<string>",
    "instructions": "<string>",
    "speak_results": true
  },
  "websocket_settings": {
    "enabled": false,
    "url": "<string>",
    "auth_ref": "<string>"
  },
  "conversation_flow": {
    "edges": [
      {
        "condition": {
          "prompt": "The caller is asking about a bill or charge.",
          "type": "llm"
        },
        "id": "e_intake_to_billing",
        "start_node_id": "n_intake",
        "target": {
          "node_id": "n_billing",
          "type": "node"
        }
      },
      {
        "condition": {
          "prompt": "The caller has explicitly asked for a human.",
          "type": "llm"
        },
        "id": "e_intake_to_escalation_assistant",
        "start_node_id": "n_intake",
        "target": {
          "assistant_id": "assistant-human-handoff",
          "position": {
            "x": 600,
            "y": 80
          },
          "type": "assistant",
          "voice_mode": "distinct"
        }
      }
    ],
    "nodes": [
      {
        "type": "prompt",
        "id": "n_intake",
        "instructions": "Greet the caller and ask what they're calling about.",
        "name": "Intake",
        "position": {
          "x": 120,
          "y": 80
        },
        "shared_tool_ids": [
          "tool-faq-kb"
        ]
      },
      {
        "type": "prompt",
        "id": "n_billing",
        "instructions": "Focus on billing questions. Look up the caller's latest invoice with the billing tool before answering.",
        "instructions_mode": "append",
        "model": "moonshotai/Kimi-K2.6",
        "name": "Billing",
        "position": {
          "x": 420,
          "y": 80
        },
        "shared_tool_ids": [
          "tool-billing-lookup"
        ],
        "tools_mode": "append"
      }
    ],
    "start_node_id": "n_intake"
  },
  "promote_to_main": true
}
EOF

{
  "id": "<string>",
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "model": "<string>",
  "instructions": "<string>",
  "version_id": "<string>",
  "version_created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "<string>",
        "description": "<string>",
        "parameters": {}
      },
      "shared": true
    }
  ],
  "mcp_servers": [],
  "a2a_agents": [],
  "greeting": "<string>",
  "llm_api_key_ref": "<string>",
  "external_llm": {
    "model": "<string>",
    "base_url": "<string>",
    "llm_api_key_ref": "<string>",
    "authentication_method": "token",
    "certificate_ref": "<string>",
    "token_retrieval_url": "<string>",
    "forward_metadata": false
  },
  "fallback_config": {
    "model": "<string>",
    "llm_api_key_ref": "<string>",
    "external_llm": {
      "model": "<string>",
      "base_url": "<string>",
      "llm_api_key_ref": "<string>",
      "authentication_method": "token",
      "certificate_ref": "<string>",
      "token_retrieval_url": "<string>",
      "forward_metadata": false
    }
  },
  "voice_settings": {
    "voice": "<string>",
    "voice_speed": 1,
    "api_key_ref": "<string>",
    "temperature": 0.5,
    "similarity_boost": 0.75,
    "use_speaker_boost": true,
    "style": 0,
    "speed": 1,
    "language_boost": null,
    "expressive_mode": false,
    "background_audio": {
      "type": "predefined_media",
      "value": "silence",
      "volume": 1
    }
  },
  "transcription": {
    "model": "deepgram/flux",
    "language": "<string>",
    "api_key_ref": "<string>",
    "region": "<string>",
    "settings": {
      "smart_format": true,
      "numerals": true,
      "eot_threshold": 0.8,
      "eot_timeout_ms": 5000,
      "eager_eot_threshold": 0.8,
      "keyterm": "<string>",
      "end_of_turn_confidence_threshold": 0.4,
      "min_turn_silence": 400,
      "max_turn_silence": 1280,
      "interim_results": false,
      "enable_endpoint_detection": false,
      "max_endpoint_delay_ms": 1750,
      "context": "<string>",
      "language_hints": [
        "<string>"
      ]
    }
  },
  "telephony_settings": {
    "default_texml_app_id": "<string>",
    "supports_unauthenticated_web_calls": true,
    "noise_suppression": "aicoustics",
    "noise_suppression_config": {
      "attenuation_limit": 100,
      "mode": "advanced",
      "family": "quail",
      "size": "vf",
      "enhancement_level": 0.8
    },
    "time_limit_secs": 1800,
    "user_idle_timeout_secs": 7205,
    "user_idle_reply_secs": 10,
    "fallback_destination": "<string>",
    "send_message_history_updates": true,
    "voicemail_detection": {
      "on_voicemail_detected": {
        "action": "stop_assistant",
        "voicemail_message": {
          "type": "prompt",
          "prompt": "<string>",
          "message": "<string>"
        }
      }
    },
    "disable_dtmf": false,
    "recording_settings": {
      "enabled": true,
      "channels": "dual",
      "format": "mp3",
      "stop_on_conversation_end": false
    }
  },
  "messaging_settings": {
    "default_messaging_profile_id": "<string>",
    "delivery_status_webhook_url": "<string>",
    "conversation_inactivity_minutes": 5000000
  },
  "enabled_features": [
    "telephony"
  ],
  "insight_settings": {
    "insight_group_id": "<string>"
  },
  "privacy_settings": {
    "data_retention": true,
    "in_transit_data_locality": false
  },
  "dynamic_variables_webhook_url": "<string>",
  "dynamic_variables_webhook_timeout_ms": 1500,
  "dynamic_variables": {},
  "import_metadata": {
    "import_provider": "elevenlabs",
    "import_id": "<string>"
  },
  "widget_settings": {
    "theme": "light",
    "audio_visualizer_config": {
      "color": "verdant",
      "preset": "<string>"
    },
    "start_call_text": "<string>",
    "default_state": "expanded",
    "position": "fixed",
    "view_history_url": "<string>",
    "report_issue_url": "<string>",
    "give_feedback_url": "<string>",
    "agent_thinking_text": "<string>",
    "speak_to_interrupt_text": "<string>",
    "logo_icon_url": "<string>"
  },
  "interruption_settings": {
    "enable": true,
    "disable_greeting_interruption": true,
    "start_speaking_plan": {
      "wait_seconds": 0.4,
      "transcription_endpointing_plan": {
        "on_punctuation_seconds": 0.1,
        "on_no_punctuation_seconds": 1.5,
        "on_number_seconds": 0.5
      }
    },
    "interrupt_prediction_threshold": 0
  },
  "integrations": [],
  "observability_settings": {
    "status": "disabled",
    "secret_key_ref": "<string>",
    "public_key_ref": "<string>",
    "host": "<string>",
    "prompt_name": "<string>",
    "prompt_version": 2,
    "prompt_label": "<string>",
    "prompt_sync": "disabled"
  },
  "version_name": "New assistant",
  "related_mission_ids": [],
  "tags": [],
  "post_conversation_settings": {
    "enabled": false
  },
  "delegation_settings": {
    "enabled": true,
    "mode": "telnyx",
    "model": "<string>",
    "llm_api_key_ref": "<string>",
    "instructions": "<string>",
    "speak_results": true,
    "external_llm": {
      "model": "<string>",
      "base_url": "<string>",
      "llm_api_key_ref": "<string>",
      "authentication_method": "token",
      "certificate_ref": "<string>",
      "token_retrieval_url": "<string>",
      "forward_metadata": false
    }
  },
  "websocket_settings": {
    "enabled": false,
    "url": "<string>",
    "auth_ref": "<string>"
  },
  "conversation_flow": {
    "edges": [
      {
        "condition": {
          "prompt": "The caller is asking about a bill or charge.",
          "type": "llm"
        },
        "id": "e_intake_to_billing",
        "start_node_id": "n_intake",
        "target": {
          "node_id": "n_billing",
          "type": "node"
        }
      },
      {
        "condition": {
          "prompt": "The caller has explicitly asked for a human.",
          "type": "llm"
        },
        "id": "e_intake_to_escalation_assistant",
        "start_node_id": "n_intake",
        "target": {
          "assistant_id": "assistant-human-handoff",
          "position": {
            "x": 600,
            "y": 80
          },
          "type": "assistant",
          "voice_mode": "distinct"
        }
      }
    ],
    "nodes": [
      {
        "type": "prompt",
        "id": "n_intake",
        "instructions": "Greet the caller and ask what they're calling about.",
        "name": "Intake",
        "position": {
          "x": 120,
          "y": 80
        },
        "shared_tool_ids": [
          "tool-faq-kb"
        ]
      },
      {
        "type": "prompt",
        "id": "n_billing",
        "instructions": "Focus on billing questions. Look up the caller's latest invoice with the billing tool before answering.",
        "instructions_mode": "append",
        "model": "moonshotai/Kimi-K2.6",
        "name": "Billing",
        "position": {
          "x": 420,
          "y": 80
        },
        "shared_tool_ids": [
          "tool-billing-lookup"
        ],
        "tools_mode": "append"
      }
    ],
    "start_node_id": "n_intake"
  }
}

{
  "errors": [
    {
      "code": "10007",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "body",
        "name"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ]
}