Session
Specifications for a Session Open request.
The Memori object ID. Required.
Password. As an alternative the minimum number of recovery tokens can be supplied in the RecoveryTokens property. If the Memori is public no password is required.
Recovery tokens, as an alternative to the Memori's password. Must be supplied in the minimum number set during Memori registration.
Optional initial tag. If specified the PIN property must also be specified. The Dialog State Machine will try to transition to the corresponding Giver or Receiver automatically. Transition may fail if Tag or PIN are incorrect, or if the Giver or Receiver have not been set up yet. When ContinueFromChatLogID is specified, Tag and PIN must match those in use in the Chat Log when the session was saved.
Optional PIN corresponding to the initial tag, expressed as a 6-digit number between 000000 and 999999. Must be specified if the Tag property is specified. When ContinueFromChatLogID is specified, Tag and PIN must match those in use in the Chat Log when the session was saved.
Optional initial question. It is sent as a Text Entered Event to the Dialog State Machine if the state session opening is R1. When ContinueFromChatLogID is specified, InitialQuestion is ignored.
Optional ID of an existing Chat Log for this Memori object, from which the session and the conversation should continue. When specified, InitialContextVars and InitialQuestion are ignored. Additionally, the Tag and PIN properties must match those in use in the Chat Log when the session was saved.
Birthdate of the user. Age verification may be applied when Memori content is NSFW or makes use of completions. If a login token is specified in the Additional Info field, the user's birth date obtained from the login token overrides whatever value is specified here. This value is never stored.
For internal use only.
POST /memori/v2/Session HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 317
{
"memoriID": "text",
"password": "text",
"recoveryTokens": [
"text"
],
"tag": "text",
"pin": "text",
"initialContextVars": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"initialQuestion": "text",
"continueFromChatLogID": "text",
"birthDate": "2025-07-13T11:02:57.403Z",
"maintenanceCode": "text",
"additionalInfo": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
}Success
{
"sessionID": "text",
"currentState": {
"state": "text",
"stateName": "text",
"previousState": "text",
"confidence": 1,
"confidenceLevel": "text",
"emission": "text",
"emittedMedia": [
{
"mediumID": "text",
"url": "text",
"content": "text",
"mimeType": "text",
"title": "text",
"properties": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"creationTimestamp": "2025-07-13T11:02:57.403Z",
"creationSessionID": "text",
"lastChangeTimestamp": "2025-07-13T11:02:57.403Z",
"lastChangeSessionID": "text"
}
],
"continuationEmitted": true,
"emitter": "text",
"completion": true,
"acceptsTimeout": true,
"acceptsAbort": true,
"acceptsMedia": true,
"acceptsDate": true,
"acceptsPlace": true,
"acceptsTag": true,
"acceptsFeedback": true,
"hints": [
"text"
],
"timeout": 1,
"currentTag": "text",
"currentTagAuthenticated": true,
"currentDate": "2025-07-13T11:02:57.403Z",
"currentPlaceName": "text",
"currentLatitude": 1,
"currentLongitude": 1,
"currentUncertaintyKm": 1,
"currentMemoryID": "text",
"lastMatchedMemoryID": "text",
"currentMedia": [
{
"mediumID": "text",
"url": "text",
"content": "text",
"mimeType": "text",
"title": "text",
"properties": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"creationTimestamp": "2025-07-13T11:02:57.403Z",
"creationSessionID": "text",
"lastChangeTimestamp": "2025-07-13T11:02:57.403Z",
"lastChangeSessionID": "text"
}
],
"contextVars": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"memoryTags": [
"text"
]
},
"requestID": 1,
"requestDateTime": "2025-07-13T11:02:57.403Z",
"resultCode": 1,
"resultMessage": "text"
}The session ID
GET /memori/v2/Session/{strSessionID} HTTP/1.1
Host:
Accept: */*
Success
{
"currentState": {
"state": "text",
"stateName": "text",
"previousState": "text",
"confidence": 1,
"confidenceLevel": "text",
"emission": "text",
"emittedMedia": [
{
"mediumID": "text",
"url": "text",
"content": "text",
"mimeType": "text",
"title": "text",
"properties": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"creationTimestamp": "2025-07-13T11:02:57.403Z",
"creationSessionID": "text",
"lastChangeTimestamp": "2025-07-13T11:02:57.403Z",
"lastChangeSessionID": "text"
}
],
"continuationEmitted": true,
"emitter": "text",
"completion": true,
"acceptsTimeout": true,
"acceptsAbort": true,
"acceptsMedia": true,
"acceptsDate": true,
"acceptsPlace": true,
"acceptsTag": true,
"acceptsFeedback": true,
"hints": [
"text"
],
"timeout": 1,
"currentTag": "text",
"currentTagAuthenticated": true,
"currentDate": "2025-07-13T11:02:57.403Z",
"currentPlaceName": "text",
"currentLatitude": 1,
"currentLongitude": 1,
"currentUncertaintyKm": 1,
"currentMemoryID": "text",
"lastMatchedMemoryID": "text",
"currentMedia": [
{
"mediumID": "text",
"url": "text",
"content": "text",
"mimeType": "text",
"title": "text",
"properties": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"creationTimestamp": "2025-07-13T11:02:57.403Z",
"creationSessionID": "text",
"lastChangeTimestamp": "2025-07-13T11:02:57.403Z",
"lastChangeSessionID": "text"
}
],
"contextVars": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"memoryTags": [
"text"
]
},
"requestID": 1,
"requestDateTime": "2025-07-13T11:02:57.403Z",
"resultCode": 1,
"resultMessage": "text"
}The session ID
DELETE /memori/v2/Session/{strSessionID} HTTP/1.1
Host:
Accept: */*
Success
{
"requestID": 1,
"requestDateTime": "2025-07-13T11:02:57.403Z",
"resultCode": 1,
"resultMessage": "text"
}