AIsuru Docs
AIsuru API
AIsuru API
  • Introduzione
  • Engine
    • ChatLogs
    • ContextVars
    • CorrelationPairs
    • CustomDictionary
    • Dialog
    • EventLogs
    • ExpertReferences
    • Functions
    • Intents
    • LocalizationKeys
    • Media
    • Memories
    • NLP
    • People
    • Search
    • Session
    • Stats
    • Topics
    • UnansweredQuestions
    • User
    • WebHooks
    • Models
  • Backend
    • ActionLog
    • Analysis
    • Asset
    • Badge
    • CompletionConfig
    • ConsumptionLog
    • ImportExport
    • Integration
    • Invitation
    • Memori
    • MemoriList
    • Notification
    • Process
    • Tenant
    • User
    • Models
Powered by GitBook
On this page
  1. Engine

Dialog

PreviousCustomDictionaryNextEventLogs

Submits a Timeout event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Responses
200
Success
application/json
post
POST /memori/v2/TimeoutEvent/{strSessionID} HTTP/1.1
Host: 
Accept: */*
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • POSTSubmits a Text Entered event to the session's Dialog State Machine.
  • POSTSubmits a Date Changed event to the session's Dialog State Machine.
  • POSTSubmits a Place Changed event to the session's Dialog State Machine.
  • POSTSubmits a Tag Changed event to the session's Dialog State Machine.
  • POSTSubmits a Timeout event to the session's Dialog State Machine.
  • POSTSubmits a Medium Selected event to the session's Dialog State Machine.
  • POSTSubmits a Medium Deselected event to the session's Dialog State Machine.
  • POSTSubmits a Date Selected event to the session's Dialog State Machine.
  • POSTSubmits a Place Selected event to the session's Dialog State Machine.
  • POSTSubmits a Tag Selected event to the session's Dialog State Machine.

Submits a Text Entered event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Text Entered event.

textstring | nullableOptional

Entered text. Required.

Responses
200
Success
application/json
post
POST /memori/v2/TextEnteredEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "text": "text"
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Date Changed event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Date Changed event. A Date Changed event changes the Current Date: the State Machine will use the new date for subsequent question resolution.

datestring | nullableOptional

New date, in the format yyyy/MM/dd HH:mm:ss zzz, e.g. 2020/01/01 09:30:00 +02. Required.

Responses
200
Success
application/json
post
POST /memori/v2/DateChangedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "date": "text"
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Place Changed event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Place Changed event. A Place Changed event changes the Current Place: the State Machine will use the new place for subsequent question resolution.

placeNamestring | nullableOptional

Name of the new place, e.g. London. If it is the only field specified, it is geocoded into latitude, longitude and uncertainty. On the other hand, if latitude and longitude are specified, the place name is stored without checking it.

latitudenumber · double | nullableOptional

Latitude of the new place, if known. E.g. 51.5285582. If specified, the longitude must also be specified. Otherwise it is ignored.

longitudenumber · double | nullableOptional

Longitude of the new place, if known. E.g. -0.2416791. If specified, the latitude must also be specified. Otherwise it is ignored.

uncertaintyKmnumber · double | nullableOptional

Radius of uncertainty of the new place, in kilometers. E.g. 20.0.

Responses
200
Success
application/json
post
POST /memori/v2/PlaceChangedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "placeName": "text",
  "latitude": 1,
  "longitude": 1,
  "uncertaintyKm": 1
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Tag Changed event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Tag Changed event. A Tag Changed event changes the Current Tag and is considered a change of the current user. The State Machine may ask for authentication, and if successful will use the new tag for subsequent question resolution.

tagstring | nullableOptional

New tag. For the anonymous/null tag use the 👤 emoji symbol. Required.

Responses
200
Success
application/json
post
POST /memori/v2/TagChangedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "tag": "text"
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Medium Selected event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Medium Selected event. A Medium Selected event is used for supplying media to be associated with a Memory or used during dialog (e.g. by an intent or generative AI).

Responses
200
Success
application/json
post
POST /memori/v2/MediumSelectedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 293

{
  "medium": {
    "mediumID": "text",
    "url": "text",
    "content": "text",
    "mimeType": "text",
    "title": "text",
    "properties": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "creationTimestamp": "2025-06-07T19:08:38.224Z",
    "creationSessionID": "text",
    "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
    "lastChangeSessionID": "text"
  }
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Medium Deselected event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Medium Deselected event. A Medium Deselected event is used for removing media from an associated Memory or from use during dialog (e.g. by an intent or generative AI).

mediumIDstring | nullableOptional

Deselected medium ID. Required.

Responses
200
Success
application/json
post
POST /memori/v2/MediumDeselectedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "mediumID": "text"
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Date Selected event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Date Selected event. A Date Selected event does not change the Current Date, it is used only for supplying a date to be associated with a Memory, using an alternative interface to the textual dialog.

datestring | nullableOptional

Selected date, in the format yyyy/MM/dd HH:mm:ss zzz, e.g. 2020/01/01 09:30:00 +02. Required.

uncertaintyDaysnumber · double | nullableOptional

Uncertainty of the date, in days. E.g. 3.5 for a period of one week centered in the date specified with Date.

Responses
200
Success
application/json
post
POST /memori/v2/DateSelectedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "date": "text",
  "uncertaintyDays": 1
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Place Selected event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Place Selected event. A Place Selected event does not change the Current Place, it is used only for supplying a place to be associated with a Memory, using an alternative interface to the textual dialog.

placeNamestring | nullableOptional

Name of the new place, e.g. London. If it is the only field specified, it is geocoded into latitude, longitude and uncertainty. On the other hand, if latitude and longitude are specified, the place name is stored without checking it.

latitudenumber · double | nullableOptional

Latitude of the new place, if known. E.g. 51.5285582. If specified, the longitude must also be specified. Otherwise it is ignored.

longitudenumber · double | nullableOptional

Longitude of the new place, if known. E.g. -0.2416791. If specified, the latitude must also be specified. Otherwise it is ignored.

uncertaintyKmnumber · double | nullableOptional

Radius of uncertainty of the new place, in kilometers. E.g. 20.0.

Responses
200
Success
application/json
post
POST /memori/v2/PlaceSelectedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "placeName": "text",
  "latitude": 1,
  "longitude": 1,
  "uncertaintyKm": 1
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Submits a Tag Selected event to the session's Dialog State Machine.

post
Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for a Tag Selected event. A Tag Selected event does not change the Current Tag, it is used only for supplying a tag to be associated with a Memory, using an alternative interface to the textual dialog.

tagstring | nullableOptional

Selected tag. The anonymous/null tag is not valid for this event. Required.

Responses
200
Success
application/json
post
POST /memori/v2/TagSelectedEvent/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "tag": "text"
}
200

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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "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-06-07T19:08:38.224Z",
    "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-06-07T19:08:38.224Z",
        "creationSessionID": "text",
        "lastChangeTimestamp": "2025-06-07T19:08:38.224Z",
        "lastChangeSessionID": "text"
      }
    ],
    "contextVars": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "memoryTags": [
      "text"
    ]
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T19:08:38.224Z",
  "resultCode": 1,
  "resultMessage": "text"
}