Update an assistant
curl --request POST \
--url https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Al-Falah credit card payment reminder",
"description": "Reminds cardholders of the due date and offers to log a payment promise",
"public": false,
"config": {
"agent": {
"instructions": "آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "al-falah"
},
"stt": {
"default": {
"provider": "soniox",
"model": "stt-rt-preview",
"language": "ur"
}
},
"tts": {
"default": {
"provider": "upliftai",
"voiceId": "v_meklc281",
"outputFormat": "MP3_22050_32"
}
},
"llm": {
"default": {
"provider": "google",
"model": "gemini-2.5-flash"
}
}
}
}
'import requests
url = "https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}"
payload = {
"name": "Al-Falah credit card payment reminder",
"description": "Reminds cardholders of the due date and offers to log a payment promise",
"public": False,
"config": {
"agent": {
"instructions": "آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": True,
"greetingInstructions": "السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "al-falah"
},
"stt": { "default": {
"provider": "soniox",
"model": "stt-rt-preview",
"language": "ur"
} },
"tts": { "default": {
"provider": "upliftai",
"voiceId": "v_meklc281",
"outputFormat": "MP3_22050_32"
} },
"llm": { "default": {
"provider": "google",
"model": "gemini-2.5-flash"
} }
}
}
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({
name: 'Al-Falah credit card payment reminder',
description: 'Reminds cardholders of the due date and offers to log a payment promise',
public: false,
config: {
agent: {
instructions: 'آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔',
initialGreeting: true,
greetingInstructions: 'السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔'
},
session: {ttl: 1800, roomPrefix: 'al-falah'},
stt: {default: {provider: 'soniox', model: 'stt-rt-preview', language: 'ur'}},
tts: {
default: {provider: 'upliftai', voiceId: 'v_meklc281', outputFormat: 'MP3_22050_32'}
},
llm: {default: {provider: 'google', model: 'gemini-2.5-flash'}}
}
})
};
fetch('https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}', 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://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}",
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([
'name' => 'Al-Falah credit card payment reminder',
'description' => 'Reminds cardholders of the due date and offers to log a payment promise',
'public' => false,
'config' => [
'agent' => [
'instructions' => 'آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔',
'initialGreeting' => true,
'greetingInstructions' => 'السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔'
],
'session' => [
'ttl' => 1800,
'roomPrefix' => 'al-falah'
],
'stt' => [
'default' => [
'provider' => 'soniox',
'model' => 'stt-rt-preview',
'language' => 'ur'
]
],
'tts' => [
'default' => [
'provider' => 'upliftai',
'voiceId' => 'v_meklc281',
'outputFormat' => 'MP3_22050_32'
]
],
'llm' => [
'default' => [
'provider' => 'google',
'model' => 'gemini-2.5-flash'
]
]
]
]),
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://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}"
payload := strings.NewReader("{\n \"name\": \"Al-Falah credit card payment reminder\",\n \"description\": \"Reminds cardholders of the due date and offers to log a payment promise\",\n \"public\": false,\n \"config\": {\n \"agent\": {\n \"instructions\": \"آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔\",\n \"initialGreeting\": true,\n \"greetingInstructions\": \"السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔\"\n },\n \"session\": {\n \"ttl\": 1800,\n \"roomPrefix\": \"al-falah\"\n },\n \"stt\": {\n \"default\": {\n \"provider\": \"soniox\",\n \"model\": \"stt-rt-preview\",\n \"language\": \"ur\"\n }\n },\n \"tts\": {\n \"default\": {\n \"provider\": \"upliftai\",\n \"voiceId\": \"v_meklc281\",\n \"outputFormat\": \"MP3_22050_32\"\n }\n },\n \"llm\": {\n \"default\": {\n \"provider\": \"google\",\n \"model\": \"gemini-2.5-flash\"\n }\n }\n }\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://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Al-Falah credit card payment reminder\",\n \"description\": \"Reminds cardholders of the due date and offers to log a payment promise\",\n \"public\": false,\n \"config\": {\n \"agent\": {\n \"instructions\": \"آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔\",\n \"initialGreeting\": true,\n \"greetingInstructions\": \"السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔\"\n },\n \"session\": {\n \"ttl\": 1800,\n \"roomPrefix\": \"al-falah\"\n },\n \"stt\": {\n \"default\": {\n \"provider\": \"soniox\",\n \"model\": \"stt-rt-preview\",\n \"language\": \"ur\"\n }\n },\n \"tts\": {\n \"default\": {\n \"provider\": \"upliftai\",\n \"voiceId\": \"v_meklc281\",\n \"outputFormat\": \"MP3_22050_32\"\n }\n },\n \"llm\": {\n \"default\": {\n \"provider\": \"google\",\n \"model\": \"gemini-2.5-flash\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}")
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 \"name\": \"Al-Falah credit card payment reminder\",\n \"description\": \"Reminds cardholders of the due date and offers to log a payment promise\",\n \"public\": false,\n \"config\": {\n \"agent\": {\n \"instructions\": \"آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔\",\n \"initialGreeting\": true,\n \"greetingInstructions\": \"السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔\"\n },\n \"session\": {\n \"ttl\": 1800,\n \"roomPrefix\": \"al-falah\"\n },\n \"stt\": {\n \"default\": {\n \"provider\": \"soniox\",\n \"model\": \"stt-rt-preview\",\n \"language\": \"ur\"\n }\n },\n \"tts\": {\n \"default\": {\n \"provider\": \"upliftai\",\n \"voiceId\": \"v_meklc281\",\n \"outputFormat\": \"MP3_22050_32\"\n }\n },\n \"llm\": {\n \"default\": {\n \"provider\": \"google\",\n \"model\": \"gemini-2.5-flash\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"realtimeAssistantId": "80b00435-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"organizationId": "a12b7e74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"projectId": "c782a4ec-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Al-Falah credit card payment reminder",
"description": "Reminds cardholders of the due date and offers to log a payment promise",
"config": {
"agent": {
"instructions": "آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "al-falah"
},
"stt": {
"default": {
"provider": "soniox",
"model": "stt-rt-preview",
"language": "ur"
}
},
"tts": {
"default": {
"provider": "upliftai",
"voiceId": "v_meklc281",
"outputFormat": "MP3_22050_32"
}
},
"llm": {
"default": {
"provider": "google",
"model": "gemini-2.5-flash"
}
}
},
"public": false,
"createdAt": "2026-08-18T04:37:53.727Z",
"updatedAt": "2026-08-18T04:39:28.828Z",
"createdBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"updatedBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"version": 6
}Assistants
Update an assistant
This replaces rather than merges, so read the assistant, change what you need, and send the whole object back. Leaving out description or public clears them — public resets to false — while name and config keep their stored values. Only populated parts of config are validated, so a config missing agent.instructions saves fine and leaves the assistant unable to take calls.
Until the assistant’s first publish, a save goes live at once. After that, an update changes the draft only. Calls and share links keep running the published version, and the public check reads it too, until you publish again.
noiseCancellation and backgroundNoise are checked on every save that sends config. An assistant stored with a bad value before these checks gets a 400 on that save until you fix it. A save without config still goes through.
POST
/
realtime-assistants
/
{realtimeAssistantId}
Update an assistant
curl --request POST \
--url https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Al-Falah credit card payment reminder",
"description": "Reminds cardholders of the due date and offers to log a payment promise",
"public": false,
"config": {
"agent": {
"instructions": "آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "al-falah"
},
"stt": {
"default": {
"provider": "soniox",
"model": "stt-rt-preview",
"language": "ur"
}
},
"tts": {
"default": {
"provider": "upliftai",
"voiceId": "v_meklc281",
"outputFormat": "MP3_22050_32"
}
},
"llm": {
"default": {
"provider": "google",
"model": "gemini-2.5-flash"
}
}
}
}
'import requests
url = "https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}"
payload = {
"name": "Al-Falah credit card payment reminder",
"description": "Reminds cardholders of the due date and offers to log a payment promise",
"public": False,
"config": {
"agent": {
"instructions": "آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": True,
"greetingInstructions": "السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "al-falah"
},
"stt": { "default": {
"provider": "soniox",
"model": "stt-rt-preview",
"language": "ur"
} },
"tts": { "default": {
"provider": "upliftai",
"voiceId": "v_meklc281",
"outputFormat": "MP3_22050_32"
} },
"llm": { "default": {
"provider": "google",
"model": "gemini-2.5-flash"
} }
}
}
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({
name: 'Al-Falah credit card payment reminder',
description: 'Reminds cardholders of the due date and offers to log a payment promise',
public: false,
config: {
agent: {
instructions: 'آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔',
initialGreeting: true,
greetingInstructions: 'السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔'
},
session: {ttl: 1800, roomPrefix: 'al-falah'},
stt: {default: {provider: 'soniox', model: 'stt-rt-preview', language: 'ur'}},
tts: {
default: {provider: 'upliftai', voiceId: 'v_meklc281', outputFormat: 'MP3_22050_32'}
},
llm: {default: {provider: 'google', model: 'gemini-2.5-flash'}}
}
})
};
fetch('https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}', 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://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}",
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([
'name' => 'Al-Falah credit card payment reminder',
'description' => 'Reminds cardholders of the due date and offers to log a payment promise',
'public' => false,
'config' => [
'agent' => [
'instructions' => 'آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔',
'initialGreeting' => true,
'greetingInstructions' => 'السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔'
],
'session' => [
'ttl' => 1800,
'roomPrefix' => 'al-falah'
],
'stt' => [
'default' => [
'provider' => 'soniox',
'model' => 'stt-rt-preview',
'language' => 'ur'
]
],
'tts' => [
'default' => [
'provider' => 'upliftai',
'voiceId' => 'v_meklc281',
'outputFormat' => 'MP3_22050_32'
]
],
'llm' => [
'default' => [
'provider' => 'google',
'model' => 'gemini-2.5-flash'
]
]
]
]),
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://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}"
payload := strings.NewReader("{\n \"name\": \"Al-Falah credit card payment reminder\",\n \"description\": \"Reminds cardholders of the due date and offers to log a payment promise\",\n \"public\": false,\n \"config\": {\n \"agent\": {\n \"instructions\": \"آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔\",\n \"initialGreeting\": true,\n \"greetingInstructions\": \"السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔\"\n },\n \"session\": {\n \"ttl\": 1800,\n \"roomPrefix\": \"al-falah\"\n },\n \"stt\": {\n \"default\": {\n \"provider\": \"soniox\",\n \"model\": \"stt-rt-preview\",\n \"language\": \"ur\"\n }\n },\n \"tts\": {\n \"default\": {\n \"provider\": \"upliftai\",\n \"voiceId\": \"v_meklc281\",\n \"outputFormat\": \"MP3_22050_32\"\n }\n },\n \"llm\": {\n \"default\": {\n \"provider\": \"google\",\n \"model\": \"gemini-2.5-flash\"\n }\n }\n }\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://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Al-Falah credit card payment reminder\",\n \"description\": \"Reminds cardholders of the due date and offers to log a payment promise\",\n \"public\": false,\n \"config\": {\n \"agent\": {\n \"instructions\": \"آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔\",\n \"initialGreeting\": true,\n \"greetingInstructions\": \"السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔\"\n },\n \"session\": {\n \"ttl\": 1800,\n \"roomPrefix\": \"al-falah\"\n },\n \"stt\": {\n \"default\": {\n \"provider\": \"soniox\",\n \"model\": \"stt-rt-preview\",\n \"language\": \"ur\"\n }\n },\n \"tts\": {\n \"default\": {\n \"provider\": \"upliftai\",\n \"voiceId\": \"v_meklc281\",\n \"outputFormat\": \"MP3_22050_32\"\n }\n },\n \"llm\": {\n \"default\": {\n \"provider\": \"google\",\n \"model\": \"gemini-2.5-flash\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.upliftai.org/v1/realtime-assistants/{realtimeAssistantId}")
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 \"name\": \"Al-Falah credit card payment reminder\",\n \"description\": \"Reminds cardholders of the due date and offers to log a payment promise\",\n \"public\": false,\n \"config\": {\n \"agent\": {\n \"instructions\": \"آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔\",\n \"initialGreeting\": true,\n \"greetingInstructions\": \"السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔\"\n },\n \"session\": {\n \"ttl\": 1800,\n \"roomPrefix\": \"al-falah\"\n },\n \"stt\": {\n \"default\": {\n \"provider\": \"soniox\",\n \"model\": \"stt-rt-preview\",\n \"language\": \"ur\"\n }\n },\n \"tts\": {\n \"default\": {\n \"provider\": \"upliftai\",\n \"voiceId\": \"v_meklc281\",\n \"outputFormat\": \"MP3_22050_32\"\n }\n },\n \"llm\": {\n \"default\": {\n \"provider\": \"google\",\n \"model\": \"gemini-2.5-flash\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"realtimeAssistantId": "80b00435-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"organizationId": "a12b7e74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"projectId": "c782a4ec-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Al-Falah credit card payment reminder",
"description": "Reminds cardholders of the due date and offers to log a payment promise",
"config": {
"agent": {
"instructions": "آپ الفلاح بینک کی جانب سے کال کر رہے ہیں۔ کارڈ ہولڈر کو ادائیگی کی آخری تاریخ یاد دلائیں، واجب الادا رقم بتائیں، اور اگر وہ ادائیگی کا وعدہ کریں تو تاریخ نوٹ کریں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، بینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ ابھی بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "al-falah"
},
"stt": {
"default": {
"provider": "soniox",
"model": "stt-rt-preview",
"language": "ur"
}
},
"tts": {
"default": {
"provider": "upliftai",
"voiceId": "v_meklc281",
"outputFormat": "MP3_22050_32"
}
},
"llm": {
"default": {
"provider": "google",
"model": "gemini-2.5-flash"
}
}
},
"public": false,
"createdAt": "2026-08-18T04:37:53.727Z",
"updatedAt": "2026-08-18T04:39:28.828Z",
"createdBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"updatedBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"version": 6
}Authorizations
Project API key (sk_api_…).
Path Parameters
Body
application/json
An empty string is accepted.
Keys beyond those listed are stored and returned unchanged.
Show child attributes
Show child attributes
Allows anyone to open a browser session against this assistant without an API key. On a published assistant, the change takes effect at the next publish.
Response
The assistant as stored after the update.
Keys beyond those listed are stored and returned unchanged.
Show child attributes
Show child attributes
Who created the assistant — an API key or a portal user.
The version this response shows. Every save bumps it, so published numbers skip the saves in between.
Required range:
x >= 1