{
  "session": {
    "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

Sessions

Create Session

Create a new conversation session for a user.

Sessions track conversation history and are used for memory extraction. Messages added to a session will be processed to extract and store long-term memories when the session is finalized.

custom_user_id: User identifier (required)
auto_process_after_seconds: Seconds of inactivity before session auto-processes (default: 600)
metadata: Optional JSON metadata to attach to the session

Returns a session object with ID and status for tracking.

POST

api

users

{custom_user_id}

sessions

{
  "session": {
    "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

Headers

X-Recallr-Project-Id

string<uuid>

required

X-Recallr-Api-Key

string

required

Path Parameters

custom_user_id

string

required

Body

application/json

auto_process_after_seconds

integer

default:600

Required range: x >= 600

metadata

object

Response

Session created successfully

session

object

required

Show child attributes

List Sessions Get Session

⌘I

Users

Sessions

Merge Conflicts

Create Session

Headers

Path Parameters

Body

Response