curl --request POST \
--url https://pria.praxislxp.com/api/auth/createInstitutionForContextid \
--header 'Content-Type: application/json' \
--data '
{
"name": "teacher1.domain.edu.instructure",
"contactEmail": "jane.doe@praxis-ai.com",
"ltiContextIds": [
"https://domain.edu/7891278"
],
"publicAuthorizedUrls": [
"https://domain.edu"
],
"ainame": "Hugo",
"picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"picture_bg": "",
"picture_dark_bg": "",
"picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"elevenlabs_agent_id": "agent_xxxxxxxxxxxxxxxxxxxx",
"prompt": "",
"domain": "domain.edu",
"account": "6430736fd62d650040420674",
"allowJoining": "disabled",
"poolCredits": true,
"creditAward": 0,
"questionType": "CORPORATE",
"rtEnabled": false,
"rtAdminOnly": true
}
'import requests
url = "https://pria.praxislxp.com/api/auth/createInstitutionForContextid"
payload = {
"name": "teacher1.domain.edu.instructure",
"contactEmail": "jane.doe@praxis-ai.com",
"ltiContextIds": ["https://domain.edu/7891278"],
"publicAuthorizedUrls": ["https://domain.edu"],
"ainame": "Hugo",
"picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"picture_bg": "",
"picture_dark_bg": "",
"picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"elevenlabs_agent_id": "agent_xxxxxxxxxxxxxxxxxxxx",
"prompt": "",
"domain": "domain.edu",
"account": "6430736fd62d650040420674",
"allowJoining": "disabled",
"poolCredits": True,
"creditAward": 0,
"questionType": "CORPORATE",
"rtEnabled": False,
"rtAdminOnly": True
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'teacher1.domain.edu.instructure',
contactEmail: 'jane.doe@praxis-ai.com',
ltiContextIds: ['https://domain.edu/7891278'],
publicAuthorizedUrls: ['https://domain.edu'],
ainame: 'Hugo',
picture: 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
picture_bg: '',
picture_dark_bg: '',
picture_animated: 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
elevenlabs_agent_id: 'agent_xxxxxxxxxxxxxxxxxxxx',
prompt: '',
domain: 'domain.edu',
account: '6430736fd62d650040420674',
allowJoining: 'disabled',
poolCredits: true,
creditAward: 0,
questionType: 'CORPORATE',
rtEnabled: false,
rtAdminOnly: true
})
};
fetch('https://pria.praxislxp.com/api/auth/createInstitutionForContextid', 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://pria.praxislxp.com/api/auth/createInstitutionForContextid",
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' => 'teacher1.domain.edu.instructure',
'contactEmail' => 'jane.doe@praxis-ai.com',
'ltiContextIds' => [
'https://domain.edu/7891278'
],
'publicAuthorizedUrls' => [
'https://domain.edu'
],
'ainame' => 'Hugo',
'picture' => 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
'picture_bg' => '',
'picture_dark_bg' => '',
'picture_animated' => 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
'elevenlabs_agent_id' => 'agent_xxxxxxxxxxxxxxxxxxxx',
'prompt' => '',
'domain' => 'domain.edu',
'account' => '6430736fd62d650040420674',
'allowJoining' => 'disabled',
'poolCredits' => true,
'creditAward' => 0,
'questionType' => 'CORPORATE',
'rtEnabled' => false,
'rtAdminOnly' => true
]),
CURLOPT_HTTPHEADER => [
"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://pria.praxislxp.com/api/auth/createInstitutionForContextid"
payload := strings.NewReader("{\n \"name\": \"teacher1.domain.edu.instructure\",\n \"contactEmail\": \"jane.doe@praxis-ai.com\",\n \"ltiContextIds\": [\n \"https://domain.edu/7891278\"\n ],\n \"publicAuthorizedUrls\": [\n \"https://domain.edu\"\n ],\n \"ainame\": \"Hugo\",\n \"picture\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"picture_bg\": \"\",\n \"picture_dark_bg\": \"\",\n \"picture_animated\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"elevenlabs_agent_id\": \"agent_xxxxxxxxxxxxxxxxxxxx\",\n \"prompt\": \"\",\n \"domain\": \"domain.edu\",\n \"account\": \"6430736fd62d650040420674\",\n \"allowJoining\": \"disabled\",\n \"poolCredits\": true,\n \"creditAward\": 0,\n \"questionType\": \"CORPORATE\",\n \"rtEnabled\": false,\n \"rtAdminOnly\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
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://pria.praxislxp.com/api/auth/createInstitutionForContextid")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"teacher1.domain.edu.instructure\",\n \"contactEmail\": \"jane.doe@praxis-ai.com\",\n \"ltiContextIds\": [\n \"https://domain.edu/7891278\"\n ],\n \"publicAuthorizedUrls\": [\n \"https://domain.edu\"\n ],\n \"ainame\": \"Hugo\",\n \"picture\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"picture_bg\": \"\",\n \"picture_dark_bg\": \"\",\n \"picture_animated\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"elevenlabs_agent_id\": \"agent_xxxxxxxxxxxxxxxxxxxx\",\n \"prompt\": \"\",\n \"domain\": \"domain.edu\",\n \"account\": \"6430736fd62d650040420674\",\n \"allowJoining\": \"disabled\",\n \"poolCredits\": true,\n \"creditAward\": 0,\n \"questionType\": \"CORPORATE\",\n \"rtEnabled\": false,\n \"rtAdminOnly\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://pria.praxislxp.com/api/auth/createInstitutionForContextid")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"teacher1.domain.edu.instructure\",\n \"contactEmail\": \"jane.doe@praxis-ai.com\",\n \"ltiContextIds\": [\n \"https://domain.edu/7891278\"\n ],\n \"publicAuthorizedUrls\": [\n \"https://domain.edu\"\n ],\n \"ainame\": \"Hugo\",\n \"picture\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"picture_bg\": \"\",\n \"picture_dark_bg\": \"\",\n \"picture_animated\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"elevenlabs_agent_id\": \"agent_xxxxxxxxxxxxxxxxxxxx\",\n \"prompt\": \"\",\n \"domain\": \"domain.edu\",\n \"account\": \"6430736fd62d650040420674\",\n \"allowJoining\": \"disabled\",\n \"poolCredits\": true,\n \"creditAward\": 0,\n \"questionType\": \"CORPORATE\",\n \"rtEnabled\": false,\n \"rtAdminOnly\": true\n}"
response = http.request(request)
puts response.read_body{
"_id": "68793ef2a8a4a5eaff36e7ca",
"name": "teacher1.domain.edu.instructure",
"picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"picture_bg": "",
"picture_dark_bg": "",
"picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"elevenlabs_agent_id": "agent_xxxxxxxxxxxxxxxxxxxx",
"credits": 50,
"status": "active",
"allowJoining": "disabled",
"joiningAdminOnly": false,
"publicId": "2e1006ec-5b59-4431-96d2-b0e1b1022a3a",
"publicAuthorizedUrls": [
"https://domain.edu"
],
"ainame": "Hugo",
"prompt": "",
"contactEmail": "jane.doe@praxis-ai.com",
"creditAward": 0,
"poolCredits": true,
"questionType": "CORPORATE",
"rtEnabled": false,
"rtAdminOnly": true,
"created": "2025-07-17T18:20:34.330Z",
"id": "68793ef2a8a4a5eaff36e7ca"
}Create a new institution (Digital Twin) for a specific context URL
Creates a new institution record with the provided configuration and context information.
The new institution’s parent account is resolved in order: the explicit account id when provided; otherwise the first account whose domainUrls contains the supplied domain; otherwise the parent account of the contactEmail user’s own institution. If none match, the institution is created without a parent account.
curl --request POST \
--url https://pria.praxislxp.com/api/auth/createInstitutionForContextid \
--header 'Content-Type: application/json' \
--data '
{
"name": "teacher1.domain.edu.instructure",
"contactEmail": "jane.doe@praxis-ai.com",
"ltiContextIds": [
"https://domain.edu/7891278"
],
"publicAuthorizedUrls": [
"https://domain.edu"
],
"ainame": "Hugo",
"picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"picture_bg": "",
"picture_dark_bg": "",
"picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"elevenlabs_agent_id": "agent_xxxxxxxxxxxxxxxxxxxx",
"prompt": "",
"domain": "domain.edu",
"account": "6430736fd62d650040420674",
"allowJoining": "disabled",
"poolCredits": true,
"creditAward": 0,
"questionType": "CORPORATE",
"rtEnabled": false,
"rtAdminOnly": true
}
'import requests
url = "https://pria.praxislxp.com/api/auth/createInstitutionForContextid"
payload = {
"name": "teacher1.domain.edu.instructure",
"contactEmail": "jane.doe@praxis-ai.com",
"ltiContextIds": ["https://domain.edu/7891278"],
"publicAuthorizedUrls": ["https://domain.edu"],
"ainame": "Hugo",
"picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"picture_bg": "",
"picture_dark_bg": "",
"picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"elevenlabs_agent_id": "agent_xxxxxxxxxxxxxxxxxxxx",
"prompt": "",
"domain": "domain.edu",
"account": "6430736fd62d650040420674",
"allowJoining": "disabled",
"poolCredits": True,
"creditAward": 0,
"questionType": "CORPORATE",
"rtEnabled": False,
"rtAdminOnly": True
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'teacher1.domain.edu.instructure',
contactEmail: 'jane.doe@praxis-ai.com',
ltiContextIds: ['https://domain.edu/7891278'],
publicAuthorizedUrls: ['https://domain.edu'],
ainame: 'Hugo',
picture: 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
picture_bg: '',
picture_dark_bg: '',
picture_animated: 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
elevenlabs_agent_id: 'agent_xxxxxxxxxxxxxxxxxxxx',
prompt: '',
domain: 'domain.edu',
account: '6430736fd62d650040420674',
allowJoining: 'disabled',
poolCredits: true,
creditAward: 0,
questionType: 'CORPORATE',
rtEnabled: false,
rtAdminOnly: true
})
};
fetch('https://pria.praxislxp.com/api/auth/createInstitutionForContextid', 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://pria.praxislxp.com/api/auth/createInstitutionForContextid",
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' => 'teacher1.domain.edu.instructure',
'contactEmail' => 'jane.doe@praxis-ai.com',
'ltiContextIds' => [
'https://domain.edu/7891278'
],
'publicAuthorizedUrls' => [
'https://domain.edu'
],
'ainame' => 'Hugo',
'picture' => 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
'picture_bg' => '',
'picture_dark_bg' => '',
'picture_animated' => 'https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif',
'elevenlabs_agent_id' => 'agent_xxxxxxxxxxxxxxxxxxxx',
'prompt' => '',
'domain' => 'domain.edu',
'account' => '6430736fd62d650040420674',
'allowJoining' => 'disabled',
'poolCredits' => true,
'creditAward' => 0,
'questionType' => 'CORPORATE',
'rtEnabled' => false,
'rtAdminOnly' => true
]),
CURLOPT_HTTPHEADER => [
"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://pria.praxislxp.com/api/auth/createInstitutionForContextid"
payload := strings.NewReader("{\n \"name\": \"teacher1.domain.edu.instructure\",\n \"contactEmail\": \"jane.doe@praxis-ai.com\",\n \"ltiContextIds\": [\n \"https://domain.edu/7891278\"\n ],\n \"publicAuthorizedUrls\": [\n \"https://domain.edu\"\n ],\n \"ainame\": \"Hugo\",\n \"picture\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"picture_bg\": \"\",\n \"picture_dark_bg\": \"\",\n \"picture_animated\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"elevenlabs_agent_id\": \"agent_xxxxxxxxxxxxxxxxxxxx\",\n \"prompt\": \"\",\n \"domain\": \"domain.edu\",\n \"account\": \"6430736fd62d650040420674\",\n \"allowJoining\": \"disabled\",\n \"poolCredits\": true,\n \"creditAward\": 0,\n \"questionType\": \"CORPORATE\",\n \"rtEnabled\": false,\n \"rtAdminOnly\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
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://pria.praxislxp.com/api/auth/createInstitutionForContextid")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"teacher1.domain.edu.instructure\",\n \"contactEmail\": \"jane.doe@praxis-ai.com\",\n \"ltiContextIds\": [\n \"https://domain.edu/7891278\"\n ],\n \"publicAuthorizedUrls\": [\n \"https://domain.edu\"\n ],\n \"ainame\": \"Hugo\",\n \"picture\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"picture_bg\": \"\",\n \"picture_dark_bg\": \"\",\n \"picture_animated\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"elevenlabs_agent_id\": \"agent_xxxxxxxxxxxxxxxxxxxx\",\n \"prompt\": \"\",\n \"domain\": \"domain.edu\",\n \"account\": \"6430736fd62d650040420674\",\n \"allowJoining\": \"disabled\",\n \"poolCredits\": true,\n \"creditAward\": 0,\n \"questionType\": \"CORPORATE\",\n \"rtEnabled\": false,\n \"rtAdminOnly\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://pria.praxislxp.com/api/auth/createInstitutionForContextid")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"teacher1.domain.edu.instructure\",\n \"contactEmail\": \"jane.doe@praxis-ai.com\",\n \"ltiContextIds\": [\n \"https://domain.edu/7891278\"\n ],\n \"publicAuthorizedUrls\": [\n \"https://domain.edu\"\n ],\n \"ainame\": \"Hugo\",\n \"picture\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"picture_bg\": \"\",\n \"picture_dark_bg\": \"\",\n \"picture_animated\": \"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif\",\n \"elevenlabs_agent_id\": \"agent_xxxxxxxxxxxxxxxxxxxx\",\n \"prompt\": \"\",\n \"domain\": \"domain.edu\",\n \"account\": \"6430736fd62d650040420674\",\n \"allowJoining\": \"disabled\",\n \"poolCredits\": true,\n \"creditAward\": 0,\n \"questionType\": \"CORPORATE\",\n \"rtEnabled\": false,\n \"rtAdminOnly\": true\n}"
response = http.request(request)
puts response.read_body{
"_id": "68793ef2a8a4a5eaff36e7ca",
"name": "teacher1.domain.edu.instructure",
"picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"picture_bg": "",
"picture_dark_bg": "",
"picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
"elevenlabs_agent_id": "agent_xxxxxxxxxxxxxxxxxxxx",
"credits": 50,
"status": "active",
"allowJoining": "disabled",
"joiningAdminOnly": false,
"publicId": "2e1006ec-5b59-4431-96d2-b0e1b1022a3a",
"publicAuthorizedUrls": [
"https://domain.edu"
],
"ainame": "Hugo",
"prompt": "",
"contactEmail": "jane.doe@praxis-ai.com",
"creditAward": 0,
"poolCredits": true,
"questionType": "CORPORATE",
"rtEnabled": false,
"rtAdminOnly": true,
"created": "2025-07-17T18:20:34.330Z",
"id": "68793ef2a8a4a5eaff36e7ca"
}Body
Institution name identifier
"teacher1.domain.edu.instructure"
Contact email for the institution
"jane.doe@praxis-ai.com"
Array of LTI context identifiers (defaults to empty array if omitted)
["https://domain.edu/7891278"]
Array of authorized public URLs
["https://domain.edu"]
AI assistant name
"Hugo"
URL to the institution's picture/avatar
"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"
Background picture URL
""
Dark mode background picture URL
""
URL to animated picture/avatar
"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"
ElevenLabs Agent ID for Digital Twin Voice
"agent_xxxxxxxxxxxxxxxxxxxx"
Custom prompt/instructions for the AI persona
""
Institution domain, used for account lookup
"domain.edu"
Parent account ObjectId (if known)
"6430736fd62d650040420674"
Who can join this Digital Twin
disabled, account, public "disabled"
Whether credits are pooled on behalf of users
true
Credits awarded to new users on registration (when poolCredits is false)
0
Type of personalization question bank (CORPORATE for Digital Twin, INSTITUTION for Digital Expert)
"CORPORATE"
Enable real-time voice conversations
false
Restrict real-time conversations to admins only
true
Response
Institution created successfully
Unique institution identifier
"68793ef2a8a4a5eaff36e7ca"
"teacher1.domain.edu.instructure"
"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"
""
""
"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"
ElevenLabs Agent ID for Digital Twin Voice
"agent_xxxxxxxxxxxxxxxxxxxx"
Total credits allocated
50
active, inactive "active"
disabled, account, public "disabled"
false
Public identifier for the institution
"2e1006ec-5b59-4431-96d2-b0e1b1022a3a"
["https://domain.edu"]
"Hugo"
""
"jane.doe@praxis-ai.com"
0
true
Personalization question bank type
"CORPORATE"
Whether real-time voice conversations are enabled
false
Whether real-time conversations are restricted to admins
true
"2025-07-17T18:20:34.330Z"
"68793ef2a8a4a5eaff36e7ca"
Was this page helpful?