Create Session

curl --request POST \
  --url https://api.recallrai.com/api/v1/users/{custom_user_id}/sessions \
  --header 'Content-Type: application/json' \
  --header 'X-Recallr-Api-Key: <x-recallr-api-key>' \
  --header 'X-Recallr-Project-Id: <x-recallr-project-id>' \
  --data '
{
  "auto_process_after_seconds": 600,
  "metadata": {},
  "custom_created_at_utc": "2026-02-14T13:07:23.322793Z"
}
'

{
  "session": {
    "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "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.

Path Parameters:

custom_user_id (str): Unique identifier for the user

Body Parameters:

auto_process_after_seconds (int): Seconds of inactivity before session auto-processes. Must be >= 600. Default: 600
metadata (Dict[str, Any]): Optional JSON metadata to attach to the session
custom_created_at_utc (datetime): Optional custom timestamp for when the session was created. Must be UTC timezone-aware. Useful for benchmarking or importing historical data. Default: current time

Returns:

session (SessionInfo): Created session with ID, status, creation timestamp, and metadata

POST

api

users

{custom_user_id}

sessions

Create Session

curl --request POST \
  --url https://api.recallrai.com/api/v1/users/{custom_user_id}/sessions \
  --header 'Content-Type: application/json' \
  --header 'X-Recallr-Api-Key: <x-recallr-api-key>' \
  --header 'X-Recallr-Project-Id: <x-recallr-project-id>' \
  --data '
{
  "auto_process_after_seconds": 600,
  "metadata": {},
  "custom_created_at_utc": "2026-02-14T13:07:23.322793Z"
}
'

{
  "session": {
    "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "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

Optional metadata for the session · object

custom_created_at_utc

string<date-time> | null

default:2026-02-14T13:07:23.322793Z

Response

Session created successfully

session

SessionInfo · object

required

Show child attributes

List Sessions Get Session

Documentation Index

Headers

Path Parameters

Body

Response