Retrieve user conversations

Gets a grouped list of all conversations (courses) for the authenticated user. Each course includes its history count, last dialogue date, and the most recently used assistant (so callers can restore conversation context on the next turn). Courses with course_id=0 are filtered out of results. Institution scoping: pass an ObjectId to scope to a twin, explicit null/empty to scope to personal history only, or omit the field to fall back to the user’s current institution.

POST /api/user/courses

Retrieve user conversations

cURL

curl --request POST \
  --url https://pria.praxislxp.com/api/user/courses \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "institution": "60d5ec49f1b2c80015a4d1a1"
}
'

200

{
  "success": true,
  "data": [
    {
      "course_id": 1750532703472,
      "course_name": "Conversation 123",
      "history_count": 12,
      "last_dialogue_date": "2025-07-01T12:00:00.000Z",
      "assistant": {
        "_id": "60d5ec49f1b2c80015a4d1a4",
        "name": "My Assistant",
        "liked_count": 5,
        "picture_url": "https://example.com/avatar.png"
      }
    }
  ]
}

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).

Response

200

application/json

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.

Show child attributes

message · string

Error message when success is false

error · object

Error object when success is false