Skip to main content
PUT
Update user institution preferences

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Path Parameters

id
string
required

The UserInstitution ObjectId to update

Body

application/json

At least one field is required. If no valid fields are provided, a 400 error is returned.

lastConversation
object
canvasApiToken
favoriteAssistants
string[]

Array of assistant ObjectIds to mark as favorites

subagentsOptIn
boolean

Turn subagents on or off for yourself in this digital twin (classic UI). Turning them on is accepted only while the twin offers subagents to you (the twin has subagents enabled and, when it restricts them to admins, you are an admin of the twin) — otherwise 403 with code subagents_not_offered.

subagentTier
enum<string>

Your execution mode for subagent turns in this twin (the mode control in the classic message box). Applied to classic sends that name no routingTier; 'auto' lets Pria decide.

Available options:
auto,
basic,
advanced,
expert,
mythical
acceptedAccountPrivacyPolicyDate

Date when user accepted the account privacy policy

favorite
boolean

Whether to mark this institution as a favorite

Response

User institution preferences updated successfully

success
boolean

Operation success status

Example:

true

message
string

Success message

Example:

"userInstitution preference saved sucessfully"