curl --request POST \
--url https://api.upliftai.org/v1/realtime-assistants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Shifa Clinic appointment confirmation",
"description": "Confirms next-day appointments for Shifa Clinic patients",
"public": false,
"config": {
"agent": {
"instructions": "آپ شفا کلینک کی جانب سے کال کر رہے ہیں۔ مریض سے کل کی اپائنٹمنٹ کی تصدیق کریں، وقت بتائیں، اور اگر وہ تاریخ بدلنا چاہیں تو نیا وقت پوچھیں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، اپنا اور کلینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "shifa-clinic"
},
"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"
}
}
}
}
'{
"realtimeAssistantId": "26932cc0-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"organizationId": "a12b7e74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"projectId": "c782a4ec-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Shifa Clinic appointment confirmation",
"description": "Confirms next-day appointments for Shifa Clinic patients",
"config": {
"agent": {
"instructions": "آپ شفا کلینک کی جانب سے کال کر رہے ہیں۔ مریض سے کل کی اپائنٹمنٹ کی تصدیق کریں، وقت بتائیں، اور اگر وہ تاریخ بدلنا چاہیں تو نیا وقت پوچھیں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، اپنا اور کلینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "shifa-clinic"
},
"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-18T02:05:22.029Z",
"updatedAt": "2026-08-18T02:05:22.029Z",
"createdBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"updatedBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"version": 1
}Assistants
Create an assistant
Returns the assistant as stored. Provider and model strings are not checked here — they resolve when a call starts, so a wrong value fails that call, not this request.
POST
/
realtime-assistants
curl --request POST \
--url https://api.upliftai.org/v1/realtime-assistants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Shifa Clinic appointment confirmation",
"description": "Confirms next-day appointments for Shifa Clinic patients",
"public": false,
"config": {
"agent": {
"instructions": "آپ شفا کلینک کی جانب سے کال کر رہے ہیں۔ مریض سے کل کی اپائنٹمنٹ کی تصدیق کریں، وقت بتائیں، اور اگر وہ تاریخ بدلنا چاہیں تو نیا وقت پوچھیں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، اپنا اور کلینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "shifa-clinic"
},
"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"
}
}
}
}
'{
"realtimeAssistantId": "26932cc0-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"organizationId": "a12b7e74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"projectId": "c782a4ec-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Shifa Clinic appointment confirmation",
"description": "Confirms next-day appointments for Shifa Clinic patients",
"config": {
"agent": {
"instructions": "آپ شفا کلینک کی جانب سے کال کر رہے ہیں۔ مریض سے کل کی اپائنٹمنٹ کی تصدیق کریں، وقت بتائیں، اور اگر وہ تاریخ بدلنا چاہیں تو نیا وقت پوچھیں۔ صرف نستعلیق اردو میں جواب دیں۔",
"initialGreeting": true,
"greetingInstructions": "السلام علیکم کہیں، اپنا اور کلینک کا تعارف کروائیں، پھر پوچھیں کہ کیا وہ بات کر سکتے ہیں۔"
},
"session": {
"ttl": 1800,
"roomPrefix": "shifa-clinic"
},
"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-18T02:05:22.029Z",
"updatedAt": "2026-08-18T02:05:22.029Z",
"createdBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"updatedBy": "ef80cc74-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"version": 1
}Authorizations
Project API key (sk_api_…).
Body
application/json
Response
The created assistant.
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