Create or replace an assistant
curl --request POST \
--url https://apiv2.vodex.ai/v1/console/assistants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"config": {
"name": "<string>",
"systemPrompt": "<string>",
"id": "<string>",
"description": "<string>",
"firstMessage": "<string>",
"firstMessageMode": "assistant-speaks-first",
"transcriber": {
"provider": "deepgram",
"model": "flux-general-en",
"language": "en"
},
"model": {
"provider": "google-vertex",
"model": "<string>",
"temperature": 1,
"customEndpointUrl": "<string>"
},
"voice": {
"provider": "cartesia",
"voiceId": "<string>",
"speed": 1.125
},
"startSpeakingPlan": {
"waitSeconds": 0.4,
"smartEndpointing": "stt-native"
},
"stopSpeakingPlan": {
"numWords": 0,
"voiceSeconds": 0.2,
"backoffSeconds": 1
},
"preemptiveGeneration": true,
"recordingEnabled": true,
"tools": [
{
"function": {
"name": "<string>",
"description": "<string>",
"parameters": {},
"serverUrl": "<string>",
"async": false
}
}
],
"transferPhoneNumber": "<string>",
"voicemail": {
"enabled": true,
"action": "hangup",
"message": "<string>"
},
"smsTool": {
"enabled": false,
"configurationId": "<string>",
"description": "<string>",
"dispatchedMessage": "<string>"
},
"callbackTool": {
"enabled": false,
"description": "<string>",
"failureMessage": "<string>",
"unconfirmedMessage": "<string>",
"pendingMessage": "<string>"
},
"maxDurationSeconds": 300,
"silenceTimeoutSeconds": 30,
"variables": {},
"tenantId": "<string>",
"webhookSecretRef": "<string>"
},
"id": "<string>"
}
'import requests
url = "https://apiv2.vodex.ai/v1/console/assistants"
payload = {
"config": {
"name": "<string>",
"systemPrompt": "<string>",
"id": "<string>",
"description": "<string>",
"firstMessage": "<string>",
"firstMessageMode": "assistant-speaks-first",
"transcriber": {
"provider": "deepgram",
"model": "flux-general-en",
"language": "en"
},
"model": {
"provider": "google-vertex",
"model": "<string>",
"temperature": 1,
"customEndpointUrl": "<string>"
},
"voice": {
"provider": "cartesia",
"voiceId": "<string>",
"speed": 1.125
},
"startSpeakingPlan": {
"waitSeconds": 0.4,
"smartEndpointing": "stt-native"
},
"stopSpeakingPlan": {
"numWords": 0,
"voiceSeconds": 0.2,
"backoffSeconds": 1
},
"preemptiveGeneration": True,
"recordingEnabled": True,
"tools": [{ "function": {
"name": "<string>",
"description": "<string>",
"parameters": {},
"serverUrl": "<string>",
"async": False
} }],
"transferPhoneNumber": "<string>",
"voicemail": {
"enabled": True,
"action": "hangup",
"message": "<string>"
},
"smsTool": {
"enabled": False,
"configurationId": "<string>",
"description": "<string>",
"dispatchedMessage": "<string>"
},
"callbackTool": {
"enabled": False,
"description": "<string>",
"failureMessage": "<string>",
"unconfirmedMessage": "<string>",
"pendingMessage": "<string>"
},
"maxDurationSeconds": 300,
"silenceTimeoutSeconds": 30,
"variables": {},
"tenantId": "<string>",
"webhookSecretRef": "<string>"
},
"id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
config: {
name: '<string>',
systemPrompt: '<string>',
id: '<string>',
description: '<string>',
firstMessage: '<string>',
firstMessageMode: 'assistant-speaks-first',
transcriber: {provider: 'deepgram', model: 'flux-general-en', language: 'en'},
model: {
provider: 'google-vertex',
model: '<string>',
temperature: 1,
customEndpointUrl: '<string>'
},
voice: {provider: 'cartesia', voiceId: '<string>', speed: 1.125},
startSpeakingPlan: {waitSeconds: 0.4, smartEndpointing: 'stt-native'},
stopSpeakingPlan: {numWords: 0, voiceSeconds: 0.2, backoffSeconds: 1},
preemptiveGeneration: true,
recordingEnabled: true,
tools: [
{
function: {
name: '<string>',
description: '<string>',
parameters: {},
serverUrl: '<string>',
async: false
}
}
],
transferPhoneNumber: '<string>',
voicemail: {enabled: true, action: 'hangup', message: '<string>'},
smsTool: {
enabled: false,
configurationId: '<string>',
description: '<string>',
dispatchedMessage: '<string>'
},
callbackTool: {
enabled: false,
description: '<string>',
failureMessage: '<string>',
unconfirmedMessage: '<string>',
pendingMessage: '<string>'
},
maxDurationSeconds: 300,
silenceTimeoutSeconds: 30,
variables: {},
tenantId: '<string>',
webhookSecretRef: '<string>'
},
id: '<string>'
})
};
fetch('https://apiv2.vodex.ai/v1/console/assistants', 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://apiv2.vodex.ai/v1/console/assistants",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'config' => [
'name' => '<string>',
'systemPrompt' => '<string>',
'id' => '<string>',
'description' => '<string>',
'firstMessage' => '<string>',
'firstMessageMode' => 'assistant-speaks-first',
'transcriber' => [
'provider' => 'deepgram',
'model' => 'flux-general-en',
'language' => 'en'
],
'model' => [
'provider' => 'google-vertex',
'model' => '<string>',
'temperature' => 1,
'customEndpointUrl' => '<string>'
],
'voice' => [
'provider' => 'cartesia',
'voiceId' => '<string>',
'speed' => 1.125
],
'startSpeakingPlan' => [
'waitSeconds' => 0.4,
'smartEndpointing' => 'stt-native'
],
'stopSpeakingPlan' => [
'numWords' => 0,
'voiceSeconds' => 0.2,
'backoffSeconds' => 1
],
'preemptiveGeneration' => true,
'recordingEnabled' => true,
'tools' => [
[
'function' => [
'name' => '<string>',
'description' => '<string>',
'parameters' => [
],
'serverUrl' => '<string>',
'async' => false
]
]
],
'transferPhoneNumber' => '<string>',
'voicemail' => [
'enabled' => true,
'action' => 'hangup',
'message' => '<string>'
],
'smsTool' => [
'enabled' => false,
'configurationId' => '<string>',
'description' => '<string>',
'dispatchedMessage' => '<string>'
],
'callbackTool' => [
'enabled' => false,
'description' => '<string>',
'failureMessage' => '<string>',
'unconfirmedMessage' => '<string>',
'pendingMessage' => '<string>'
],
'maxDurationSeconds' => 300,
'silenceTimeoutSeconds' => 30,
'variables' => [
],
'tenantId' => '<string>',
'webhookSecretRef' => '<string>'
],
'id' => '<string>'
]),
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://apiv2.vodex.ai/v1/console/assistants"
payload := strings.NewReader("{\n \"config\": {\n \"name\": \"<string>\",\n \"systemPrompt\": \"<string>\",\n \"id\": \"<string>\",\n \"description\": \"<string>\",\n \"firstMessage\": \"<string>\",\n \"firstMessageMode\": \"assistant-speaks-first\",\n \"transcriber\": {\n \"provider\": \"deepgram\",\n \"model\": \"flux-general-en\",\n \"language\": \"en\"\n },\n \"model\": {\n \"provider\": \"google-vertex\",\n \"model\": \"<string>\",\n \"temperature\": 1,\n \"customEndpointUrl\": \"<string>\"\n },\n \"voice\": {\n \"provider\": \"cartesia\",\n \"voiceId\": \"<string>\",\n \"speed\": 1.125\n },\n \"startSpeakingPlan\": {\n \"waitSeconds\": 0.4,\n \"smartEndpointing\": \"stt-native\"\n },\n \"stopSpeakingPlan\": {\n \"numWords\": 0,\n \"voiceSeconds\": 0.2,\n \"backoffSeconds\": 1\n },\n \"preemptiveGeneration\": true,\n \"recordingEnabled\": true,\n \"tools\": [\n {\n \"function\": {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"parameters\": {},\n \"serverUrl\": \"<string>\",\n \"async\": false\n }\n }\n ],\n \"transferPhoneNumber\": \"<string>\",\n \"voicemail\": {\n \"enabled\": true,\n \"action\": \"hangup\",\n \"message\": \"<string>\"\n },\n \"smsTool\": {\n \"enabled\": false,\n \"configurationId\": \"<string>\",\n \"description\": \"<string>\",\n \"dispatchedMessage\": \"<string>\"\n },\n \"callbackTool\": {\n \"enabled\": false,\n \"description\": \"<string>\",\n \"failureMessage\": \"<string>\",\n \"unconfirmedMessage\": \"<string>\",\n \"pendingMessage\": \"<string>\"\n },\n \"maxDurationSeconds\": 300,\n \"silenceTimeoutSeconds\": 30,\n \"variables\": {},\n \"tenantId\": \"<string>\",\n \"webhookSecretRef\": \"<string>\"\n },\n \"id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://apiv2.vodex.ai/v1/console/assistants")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"config\": {\n \"name\": \"<string>\",\n \"systemPrompt\": \"<string>\",\n \"id\": \"<string>\",\n \"description\": \"<string>\",\n \"firstMessage\": \"<string>\",\n \"firstMessageMode\": \"assistant-speaks-first\",\n \"transcriber\": {\n \"provider\": \"deepgram\",\n \"model\": \"flux-general-en\",\n \"language\": \"en\"\n },\n \"model\": {\n \"provider\": \"google-vertex\",\n \"model\": \"<string>\",\n \"temperature\": 1,\n \"customEndpointUrl\": \"<string>\"\n },\n \"voice\": {\n \"provider\": \"cartesia\",\n \"voiceId\": \"<string>\",\n \"speed\": 1.125\n },\n \"startSpeakingPlan\": {\n \"waitSeconds\": 0.4,\n \"smartEndpointing\": \"stt-native\"\n },\n \"stopSpeakingPlan\": {\n \"numWords\": 0,\n \"voiceSeconds\": 0.2,\n \"backoffSeconds\": 1\n },\n \"preemptiveGeneration\": true,\n \"recordingEnabled\": true,\n \"tools\": [\n {\n \"function\": {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"parameters\": {},\n \"serverUrl\": \"<string>\",\n \"async\": false\n }\n }\n ],\n \"transferPhoneNumber\": \"<string>\",\n \"voicemail\": {\n \"enabled\": true,\n \"action\": \"hangup\",\n \"message\": \"<string>\"\n },\n \"smsTool\": {\n \"enabled\": false,\n \"configurationId\": \"<string>\",\n \"description\": \"<string>\",\n \"dispatchedMessage\": \"<string>\"\n },\n \"callbackTool\": {\n \"enabled\": false,\n \"description\": \"<string>\",\n \"failureMessage\": \"<string>\",\n \"unconfirmedMessage\": \"<string>\",\n \"pendingMessage\": \"<string>\"\n },\n \"maxDurationSeconds\": 300,\n \"silenceTimeoutSeconds\": 30,\n \"variables\": {},\n \"tenantId\": \"<string>\",\n \"webhookSecretRef\": \"<string>\"\n },\n \"id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.vodex.ai/v1/console/assistants")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"config\": {\n \"name\": \"<string>\",\n \"systemPrompt\": \"<string>\",\n \"id\": \"<string>\",\n \"description\": \"<string>\",\n \"firstMessage\": \"<string>\",\n \"firstMessageMode\": \"assistant-speaks-first\",\n \"transcriber\": {\n \"provider\": \"deepgram\",\n \"model\": \"flux-general-en\",\n \"language\": \"en\"\n },\n \"model\": {\n \"provider\": \"google-vertex\",\n \"model\": \"<string>\",\n \"temperature\": 1,\n \"customEndpointUrl\": \"<string>\"\n },\n \"voice\": {\n \"provider\": \"cartesia\",\n \"voiceId\": \"<string>\",\n \"speed\": 1.125\n },\n \"startSpeakingPlan\": {\n \"waitSeconds\": 0.4,\n \"smartEndpointing\": \"stt-native\"\n },\n \"stopSpeakingPlan\": {\n \"numWords\": 0,\n \"voiceSeconds\": 0.2,\n \"backoffSeconds\": 1\n },\n \"preemptiveGeneration\": true,\n \"recordingEnabled\": true,\n \"tools\": [\n {\n \"function\": {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"parameters\": {},\n \"serverUrl\": \"<string>\",\n \"async\": false\n }\n }\n ],\n \"transferPhoneNumber\": \"<string>\",\n \"voicemail\": {\n \"enabled\": true,\n \"action\": \"hangup\",\n \"message\": \"<string>\"\n },\n \"smsTool\": {\n \"enabled\": false,\n \"configurationId\": \"<string>\",\n \"description\": \"<string>\",\n \"dispatchedMessage\": \"<string>\"\n },\n \"callbackTool\": {\n \"enabled\": false,\n \"description\": \"<string>\",\n \"failureMessage\": \"<string>\",\n \"unconfirmedMessage\": \"<string>\",\n \"pendingMessage\": \"<string>\"\n },\n \"maxDurationSeconds\": 300,\n \"silenceTimeoutSeconds\": 30,\n \"variables\": {},\n \"tenantId\": \"<string>\",\n \"webhookSecretRef\": \"<string>\"\n },\n \"id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"configPublished": true
}{
"error": "not found"
}Assistants
Create or replace an assistant
id is optional — without it, the slug is derived from config.name.
A save is validated three ways before it lands, so a bad config fails
here rather than mid-call:
- Catalog slots — the engine/model/transcriber/voice combination must exist in the model catalog (a mismatch is a call that dies on the worker with an error nobody connects back to this save).
- Custom tool URLs — https, no credentials in the URL, no private or link-local destinations. The worker re-validates at call time because DNS can change in between.
- The name must be non-empty and the slug must match
^[a-z0-9][a-z0-9-]{1,60}$.
On success the config snapshot is republished to the cells’ GCS bucket
and awaited, so configPublished tells the console whether the save
actually reached them. The config itself is already durable regardless;
cells otherwise converge within the snapshot TTL.
POST
/
console
/
assistants
Create or replace an assistant
curl --request POST \
--url https://apiv2.vodex.ai/v1/console/assistants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"config": {
"name": "<string>",
"systemPrompt": "<string>",
"id": "<string>",
"description": "<string>",
"firstMessage": "<string>",
"firstMessageMode": "assistant-speaks-first",
"transcriber": {
"provider": "deepgram",
"model": "flux-general-en",
"language": "en"
},
"model": {
"provider": "google-vertex",
"model": "<string>",
"temperature": 1,
"customEndpointUrl": "<string>"
},
"voice": {
"provider": "cartesia",
"voiceId": "<string>",
"speed": 1.125
},
"startSpeakingPlan": {
"waitSeconds": 0.4,
"smartEndpointing": "stt-native"
},
"stopSpeakingPlan": {
"numWords": 0,
"voiceSeconds": 0.2,
"backoffSeconds": 1
},
"preemptiveGeneration": true,
"recordingEnabled": true,
"tools": [
{
"function": {
"name": "<string>",
"description": "<string>",
"parameters": {},
"serverUrl": "<string>",
"async": false
}
}
],
"transferPhoneNumber": "<string>",
"voicemail": {
"enabled": true,
"action": "hangup",
"message": "<string>"
},
"smsTool": {
"enabled": false,
"configurationId": "<string>",
"description": "<string>",
"dispatchedMessage": "<string>"
},
"callbackTool": {
"enabled": false,
"description": "<string>",
"failureMessage": "<string>",
"unconfirmedMessage": "<string>",
"pendingMessage": "<string>"
},
"maxDurationSeconds": 300,
"silenceTimeoutSeconds": 30,
"variables": {},
"tenantId": "<string>",
"webhookSecretRef": "<string>"
},
"id": "<string>"
}
'import requests
url = "https://apiv2.vodex.ai/v1/console/assistants"
payload = {
"config": {
"name": "<string>",
"systemPrompt": "<string>",
"id": "<string>",
"description": "<string>",
"firstMessage": "<string>",
"firstMessageMode": "assistant-speaks-first",
"transcriber": {
"provider": "deepgram",
"model": "flux-general-en",
"language": "en"
},
"model": {
"provider": "google-vertex",
"model": "<string>",
"temperature": 1,
"customEndpointUrl": "<string>"
},
"voice": {
"provider": "cartesia",
"voiceId": "<string>",
"speed": 1.125
},
"startSpeakingPlan": {
"waitSeconds": 0.4,
"smartEndpointing": "stt-native"
},
"stopSpeakingPlan": {
"numWords": 0,
"voiceSeconds": 0.2,
"backoffSeconds": 1
},
"preemptiveGeneration": True,
"recordingEnabled": True,
"tools": [{ "function": {
"name": "<string>",
"description": "<string>",
"parameters": {},
"serverUrl": "<string>",
"async": False
} }],
"transferPhoneNumber": "<string>",
"voicemail": {
"enabled": True,
"action": "hangup",
"message": "<string>"
},
"smsTool": {
"enabled": False,
"configurationId": "<string>",
"description": "<string>",
"dispatchedMessage": "<string>"
},
"callbackTool": {
"enabled": False,
"description": "<string>",
"failureMessage": "<string>",
"unconfirmedMessage": "<string>",
"pendingMessage": "<string>"
},
"maxDurationSeconds": 300,
"silenceTimeoutSeconds": 30,
"variables": {},
"tenantId": "<string>",
"webhookSecretRef": "<string>"
},
"id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
config: {
name: '<string>',
systemPrompt: '<string>',
id: '<string>',
description: '<string>',
firstMessage: '<string>',
firstMessageMode: 'assistant-speaks-first',
transcriber: {provider: 'deepgram', model: 'flux-general-en', language: 'en'},
model: {
provider: 'google-vertex',
model: '<string>',
temperature: 1,
customEndpointUrl: '<string>'
},
voice: {provider: 'cartesia', voiceId: '<string>', speed: 1.125},
startSpeakingPlan: {waitSeconds: 0.4, smartEndpointing: 'stt-native'},
stopSpeakingPlan: {numWords: 0, voiceSeconds: 0.2, backoffSeconds: 1},
preemptiveGeneration: true,
recordingEnabled: true,
tools: [
{
function: {
name: '<string>',
description: '<string>',
parameters: {},
serverUrl: '<string>',
async: false
}
}
],
transferPhoneNumber: '<string>',
voicemail: {enabled: true, action: 'hangup', message: '<string>'},
smsTool: {
enabled: false,
configurationId: '<string>',
description: '<string>',
dispatchedMessage: '<string>'
},
callbackTool: {
enabled: false,
description: '<string>',
failureMessage: '<string>',
unconfirmedMessage: '<string>',
pendingMessage: '<string>'
},
maxDurationSeconds: 300,
silenceTimeoutSeconds: 30,
variables: {},
tenantId: '<string>',
webhookSecretRef: '<string>'
},
id: '<string>'
})
};
fetch('https://apiv2.vodex.ai/v1/console/assistants', 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://apiv2.vodex.ai/v1/console/assistants",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'config' => [
'name' => '<string>',
'systemPrompt' => '<string>',
'id' => '<string>',
'description' => '<string>',
'firstMessage' => '<string>',
'firstMessageMode' => 'assistant-speaks-first',
'transcriber' => [
'provider' => 'deepgram',
'model' => 'flux-general-en',
'language' => 'en'
],
'model' => [
'provider' => 'google-vertex',
'model' => '<string>',
'temperature' => 1,
'customEndpointUrl' => '<string>'
],
'voice' => [
'provider' => 'cartesia',
'voiceId' => '<string>',
'speed' => 1.125
],
'startSpeakingPlan' => [
'waitSeconds' => 0.4,
'smartEndpointing' => 'stt-native'
],
'stopSpeakingPlan' => [
'numWords' => 0,
'voiceSeconds' => 0.2,
'backoffSeconds' => 1
],
'preemptiveGeneration' => true,
'recordingEnabled' => true,
'tools' => [
[
'function' => [
'name' => '<string>',
'description' => '<string>',
'parameters' => [
],
'serverUrl' => '<string>',
'async' => false
]
]
],
'transferPhoneNumber' => '<string>',
'voicemail' => [
'enabled' => true,
'action' => 'hangup',
'message' => '<string>'
],
'smsTool' => [
'enabled' => false,
'configurationId' => '<string>',
'description' => '<string>',
'dispatchedMessage' => '<string>'
],
'callbackTool' => [
'enabled' => false,
'description' => '<string>',
'failureMessage' => '<string>',
'unconfirmedMessage' => '<string>',
'pendingMessage' => '<string>'
],
'maxDurationSeconds' => 300,
'silenceTimeoutSeconds' => 30,
'variables' => [
],
'tenantId' => '<string>',
'webhookSecretRef' => '<string>'
],
'id' => '<string>'
]),
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://apiv2.vodex.ai/v1/console/assistants"
payload := strings.NewReader("{\n \"config\": {\n \"name\": \"<string>\",\n \"systemPrompt\": \"<string>\",\n \"id\": \"<string>\",\n \"description\": \"<string>\",\n \"firstMessage\": \"<string>\",\n \"firstMessageMode\": \"assistant-speaks-first\",\n \"transcriber\": {\n \"provider\": \"deepgram\",\n \"model\": \"flux-general-en\",\n \"language\": \"en\"\n },\n \"model\": {\n \"provider\": \"google-vertex\",\n \"model\": \"<string>\",\n \"temperature\": 1,\n \"customEndpointUrl\": \"<string>\"\n },\n \"voice\": {\n \"provider\": \"cartesia\",\n \"voiceId\": \"<string>\",\n \"speed\": 1.125\n },\n \"startSpeakingPlan\": {\n \"waitSeconds\": 0.4,\n \"smartEndpointing\": \"stt-native\"\n },\n \"stopSpeakingPlan\": {\n \"numWords\": 0,\n \"voiceSeconds\": 0.2,\n \"backoffSeconds\": 1\n },\n \"preemptiveGeneration\": true,\n \"recordingEnabled\": true,\n \"tools\": [\n {\n \"function\": {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"parameters\": {},\n \"serverUrl\": \"<string>\",\n \"async\": false\n }\n }\n ],\n \"transferPhoneNumber\": \"<string>\",\n \"voicemail\": {\n \"enabled\": true,\n \"action\": \"hangup\",\n \"message\": \"<string>\"\n },\n \"smsTool\": {\n \"enabled\": false,\n \"configurationId\": \"<string>\",\n \"description\": \"<string>\",\n \"dispatchedMessage\": \"<string>\"\n },\n \"callbackTool\": {\n \"enabled\": false,\n \"description\": \"<string>\",\n \"failureMessage\": \"<string>\",\n \"unconfirmedMessage\": \"<string>\",\n \"pendingMessage\": \"<string>\"\n },\n \"maxDurationSeconds\": 300,\n \"silenceTimeoutSeconds\": 30,\n \"variables\": {},\n \"tenantId\": \"<string>\",\n \"webhookSecretRef\": \"<string>\"\n },\n \"id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://apiv2.vodex.ai/v1/console/assistants")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"config\": {\n \"name\": \"<string>\",\n \"systemPrompt\": \"<string>\",\n \"id\": \"<string>\",\n \"description\": \"<string>\",\n \"firstMessage\": \"<string>\",\n \"firstMessageMode\": \"assistant-speaks-first\",\n \"transcriber\": {\n \"provider\": \"deepgram\",\n \"model\": \"flux-general-en\",\n \"language\": \"en\"\n },\n \"model\": {\n \"provider\": \"google-vertex\",\n \"model\": \"<string>\",\n \"temperature\": 1,\n \"customEndpointUrl\": \"<string>\"\n },\n \"voice\": {\n \"provider\": \"cartesia\",\n \"voiceId\": \"<string>\",\n \"speed\": 1.125\n },\n \"startSpeakingPlan\": {\n \"waitSeconds\": 0.4,\n \"smartEndpointing\": \"stt-native\"\n },\n \"stopSpeakingPlan\": {\n \"numWords\": 0,\n \"voiceSeconds\": 0.2,\n \"backoffSeconds\": 1\n },\n \"preemptiveGeneration\": true,\n \"recordingEnabled\": true,\n \"tools\": [\n {\n \"function\": {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"parameters\": {},\n \"serverUrl\": \"<string>\",\n \"async\": false\n }\n }\n ],\n \"transferPhoneNumber\": \"<string>\",\n \"voicemail\": {\n \"enabled\": true,\n \"action\": \"hangup\",\n \"message\": \"<string>\"\n },\n \"smsTool\": {\n \"enabled\": false,\n \"configurationId\": \"<string>\",\n \"description\": \"<string>\",\n \"dispatchedMessage\": \"<string>\"\n },\n \"callbackTool\": {\n \"enabled\": false,\n \"description\": \"<string>\",\n \"failureMessage\": \"<string>\",\n \"unconfirmedMessage\": \"<string>\",\n \"pendingMessage\": \"<string>\"\n },\n \"maxDurationSeconds\": 300,\n \"silenceTimeoutSeconds\": 30,\n \"variables\": {},\n \"tenantId\": \"<string>\",\n \"webhookSecretRef\": \"<string>\"\n },\n \"id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.vodex.ai/v1/console/assistants")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"config\": {\n \"name\": \"<string>\",\n \"systemPrompt\": \"<string>\",\n \"id\": \"<string>\",\n \"description\": \"<string>\",\n \"firstMessage\": \"<string>\",\n \"firstMessageMode\": \"assistant-speaks-first\",\n \"transcriber\": {\n \"provider\": \"deepgram\",\n \"model\": \"flux-general-en\",\n \"language\": \"en\"\n },\n \"model\": {\n \"provider\": \"google-vertex\",\n \"model\": \"<string>\",\n \"temperature\": 1,\n \"customEndpointUrl\": \"<string>\"\n },\n \"voice\": {\n \"provider\": \"cartesia\",\n \"voiceId\": \"<string>\",\n \"speed\": 1.125\n },\n \"startSpeakingPlan\": {\n \"waitSeconds\": 0.4,\n \"smartEndpointing\": \"stt-native\"\n },\n \"stopSpeakingPlan\": {\n \"numWords\": 0,\n \"voiceSeconds\": 0.2,\n \"backoffSeconds\": 1\n },\n \"preemptiveGeneration\": true,\n \"recordingEnabled\": true,\n \"tools\": [\n {\n \"function\": {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"parameters\": {},\n \"serverUrl\": \"<string>\",\n \"async\": false\n }\n }\n ],\n \"transferPhoneNumber\": \"<string>\",\n \"voicemail\": {\n \"enabled\": true,\n \"action\": \"hangup\",\n \"message\": \"<string>\"\n },\n \"smsTool\": {\n \"enabled\": false,\n \"configurationId\": \"<string>\",\n \"description\": \"<string>\",\n \"dispatchedMessage\": \"<string>\"\n },\n \"callbackTool\": {\n \"enabled\": false,\n \"description\": \"<string>\",\n \"failureMessage\": \"<string>\",\n \"unconfirmedMessage\": \"<string>\",\n \"pendingMessage\": \"<string>\"\n },\n \"maxDurationSeconds\": 300,\n \"silenceTimeoutSeconds\": 30,\n \"variables\": {},\n \"tenantId\": \"<string>\",\n \"webhookSecretRef\": \"<string>\"\n },\n \"id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"configPublished": true
}{
"error": "not found"
}Authorizations
Tenant API key (vdx_live_…) as Authorization: Bearer.
Body
application/json