Clear history records (soft delete)
Soft-deletes history records by setting forgotten=true. Two operation modes: (1) course_id deletes a conversation within the resolved institution scope and detaches its favorites, (2) id deletes a single record. Favorites in a course are detached (course_id/course_name removed) rather than deleted. course_id mode supports institution scoping (ObjectId / explicit null = personal / omitted = user.institution fallback); allInstitutions:true is rejected with 400.
Documentation Index
Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
JWT token passed in x-access-token header
Body
Two mutually exclusive modes. Provide exactly one of: course_id, or id. The course_id mode also accepts an optional institution scope.
Course identifier. Detaches favorites from the course (unsets course_id/course_name) then soft-deletes remaining course records within the resolved institution scope. course_id=0 sweeps the unassigned bucket (records with course_id 0, null, or missing).
1750532703472
Institution scope (course_id mode only). Three-state: (1) valid ObjectId scopes to that twin (membership-checked — 403 if the user is not an active member), (2) explicit null/empty scopes to personal/null history, (3) field omitted falls back to the user's current institution. Malformed ObjectId returns 400.
ObjectId of a single history record to soft-delete. Single-record operations are not institution-scoped (the _id is globally unique).
"688b024f7db6fe6e921399e3"
Was this page helpful?