Skip to main content
POST
Create a new institution

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
name
string
required

Institution name/domain

account
string
required

Account ID reference

status
enum<string>
default:active
Available options:
active,
inactive
credits
integer

Initial credits

publicId
string

Public UUID identifier

ainame
string
default:Pria

AI assistant name

personaMode
boolean
default:true

Persona twin — outward presentation is governed by the twin's own instructions; platform capability/onboarding prompt rules become persona-aware. Newly created twins default to on; omit to accept the default.

contactEmail
string<email>

Contact email

poolCredits
boolean
default:true

Pool credits between users

creditCaps
object

Per-institution user-quota configuration. Editable by admins with the institutions.edit entitlement when the account has not enabled caps; read-only (inherited) when the account owns caps.

Response

Institution created successfully

success
boolean
id
string

New institution ID

message
string