Skip to main content
POST

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
institution
string | null

Institution ObjectId. Three-state semantics: (1) valid ObjectId scopes to that twin, (2) explicit null/empty scopes to personal/null history, (3) field omitted falls back to the user's current institution (or personal if none). Ignored when allInstitutions is true.

allInstitutions
boolean
default:false

When true, list conversations across ALL institutions the user is actively enrolled in PLUS the personal account (histories with no institution). Overrides institution. Conversations are then keyed on {course_id, institution} — the same course_id can appear once per twin — and every row carries an institution badge ({_id, name, ainame, picture, slug} | {personal: true} | {_id, unknown: true} for a deleted twin). Omitted/false: unchanged single-scope behaviour.

Response

Successfully retrieved user courses

success
boolean

Indicates if the request was successful

data
object[]

Array of course objects sorted by last_dialogue_date descending. Courses with course_id=0 are excluded.

message
string

Error message when success is false

error
object

Error object when success is false