Skip to main content
POST
/
api
/
auth
/
createInstitutionForContextid
Create a new institution (Digital Twin) for a specific context URL
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_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
  "prompt": "",
  "domain": "domain.edu"
}'
{
  "_id": "68793ef2a8a4a5eaff36e7ca",
  "name": "teacher1.domain.edu.instructure",
  "picture": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
  "picture_bg": "",
  "picture_animated": "https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif",
  "credits": 50,
  "creditsUsed": 0,
  "creditsAwarded": 0,
  "creditsTotal": 50,
  "creditsUsagePct": 0,
  "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,
  "invoices_urls": [],
  "kmeanScore": 0.45,
  "ragLimitChunks": 2,
  "maxCompletionTokens": -1,
  "disableFileUploadForUser": false,
  "toolsDisabled": [],
  "ltiContextIds": [
    "https://domain.edu/7891278"
  ],
  "canvasAPIScope": [
    "url:GET|/api/v1/courses/:course_id/smartsearch"
  ],
  "personalisationAsked": false,
  "kalturaIsAdminSecret": false,
  "entitleNewAdmins": false,
  "locationEnabled": true,
  "enableModeration": false,
  "alwaysCiteSources": true,
  "rtEnabled": false,
  "rtAdminOnly": true,
  "displayAgentDetails": true,
  "assistantsDisabled": [],
  "disableAssistantsForUser": false,
  "rtVoice": "",
  "maxFiles": 300,
  "questionType": "CORPORATE",
  "created": "2025-07-17T18:20:34.330Z",
  "id": "68793ef2a8a4a5eaff36e7ca"
}

Body

application/json
​
name
string
required

Institution name identifier

Example:

"teacher1.domain.edu.instructure"

​
contactEmail
string<email>
required

Contact email for the institution

Example:

"jane.doe@praxis-ai.com"

​
ltiContextIds
string[]
required

Array of LTI context identifiers

Example:
["https://domain.edu/7891278"]
​
publicAuthorizedUrls
string[]

Array of authorized public URLs

Example:
["https://domain.edu"]
​
ainame
string

AI assistant name

Example:

"Hugo"

​
picture
string<uri>

URL to the institution's picture/avatar

Example:

"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"

​
picture_bg
string

Background picture URL

Example:

""

​
picture_animated
string<uri>

URL to animated picture/avatar

Example:

"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"

​
prompt
string

Custom prompt for the AI

Example:

""

​
domain
string

Institution domain

Example:

"domain.edu"

Response

Institution created successfully

​
_id
string

Unique institution identifier

Example:

"68793ef2a8a4a5eaff36e7ca"

​
name
string
Example:

"teacher1.domain.edu.instructure"

​
picture
string<uri>
Example:

"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"

​
picture_bg
string
Example:

""

​
picture_animated
string<uri>
Example:

"https://hiimpria.ai/uploads/6430736fd62d650040420674/Clarkey20Headshot20Animated_1752713782148.gif"

​
credits
number

Total credits allocated

Example:

50

​
creditsUsed
number

Credits consumed

Example:

0

​
creditsAwarded
number

Credits awarded

Example:

0

​
creditsTotal
number

Total available credits

Example:

50

​
creditsUsagePct
number

Percentage of credits used

Example:

0

​
status
enum<string>
Available options:
active,
inactive
Example:

"active"

​
allowJoining
enum<string>
Available options:
enabled,
disabled
Example:

"disabled"

​
joiningAdminOnly
boolean
Example:

false

​
publicId
string<uuid>

Public identifier for the institution

Example:

"2e1006ec-5b59-4431-96d2-b0e1b1022a3a"

​
publicAuthorizedUrls
string[]
Example:
["https://domain.edu"]
​
ainame
string
Example:

"Hugo"

​
prompt
string
Example:

""

​
contactEmail
string<email>
Example:

"jane.doe@praxis-ai.com"

​
creditAward
number
Example:

0

​
poolCredits
boolean
Example:

true

​
invoices_urls
string[]
Example:
[]
​
kmeanScore
number
Example:

0.45

​
ragLimitChunks
number
Example:

2

​
maxCompletionTokens
number
Example:

-1

​
disableFileUploadForUser
boolean
Example:

false

​
toolsDisabled
string[]
Example:
[]
​
ltiContextIds
string[]
Example:
["https://domain.edu/7891278"]
​
canvasAPIScope
string[]
Example:
[
  "url:GET|/api/v1/courses/:course_id/smartsearch"
]
​
personalisationAsked
boolean
Example:

false

​
kalturaIsAdminSecret
boolean
Example:

false

​
entitleNewAdmins
boolean
Example:

false

​
locationEnabled
boolean
Example:

true

​
enableModeration
boolean
Example:

false

​
alwaysCiteSources
boolean
Example:

true

​
rtEnabled
boolean
Example:

false

​
rtAdminOnly
boolean
Example:

true

​
displayAgentDetails
boolean
Example:

true

​
assistantsDisabled
string[]
Example:
[]
​
disableAssistantsForUser
boolean
Example:

false

​
rtVoice
string
Example:

""

​
maxFiles
number
Example:

300

​
questionType
enum<string>
Available options:
CORPORATE,
ACADEMIC,
PERSONAL
Example:

"CORPORATE"

​
created
string<date-time>
Example:

"2025-07-17T18:20:34.330Z"

​
id
string
Example:

"68793ef2a8a4a5eaff36e7ca"

⌘I