Reset a session

POST

/v1/sessions/:session_id/reset

POST

/v1/sessions/:session_id/reset

$ curl -X POST https://api.loreos.app/v1/sessions/00000000-0000-0000-0000-000000000000/reset \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "reason": "User wants to start over.",
>   "move_channel_bindings": true
> }'

1 {
2   "schema_version": "v1",
3   "data": {
4     "previous_session_id": "00000000-0000-0000-0000-000000000000",
5     "session_id": "11111111-1111-1111-1111-111111111111",
6     "character": "yura",
7     "external_user_ref": "user_123",
8     "initial_event_cursor": 1,
9     "reset_event_cursor": 9,
10     "channel_bindings_moved": 1,
11     "language_guard": {
12       "requested_locale": "ko-KR",
13       "supported_input_languages": [
14         "ko-KR"
15       ],
16       "input_language_policy": "enforce_supported_input"
17     },
18     "semantics": {
19       "creates_fresh_session": true,
20       "previous_session_retained": true,
21       "previous_session_lifecycle_unchanged": true,
22       "deletes_memory": false,
23       "overwrites_canon": false,
24       "moves_channel_bindings": true
25     }
26   },
27   "next_actions": [
28     {
29       "command": "POST /v1/sessions/11111111-1111-1111-1111-111111111111/messages {\"text\": \"안녕!\"}",
30       "description": "Send the first user message in the reset session."
31     }
32   ]
33 }

Start this user-character pair over with a fresh session.

Reset mirrors managed Telegram /reset: it creates a new app-owned session for the same external user and character, optionally moves active delivery-channel bindings to the new session, and leaves the previous session/memories intact for audit/history. Use the memory delete APIs when the product intent is forgetting.

Authentication

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

Path parameters

session_idstringRequired

Request

This endpoint expects a nullable object.

reasonstring or nullOptional<=500 characters

move_channel_bindingsbooleanOptionalDefaults to true

When true, active delivery-channel bindings for the previous session move to the freshly created session. This matches managed Telegram /reset semantics.

Response

Successful Response

Errors

422

Unprocessable Entity Error