Create Session

Creating a session

at the beginning of each conversation with each user or group a session must be established, this session must not change throughout the conversation unless it has expired or is no longer available due to an AI Error.

If a new session ID gets established for each incoming message, this will result in weird conversations that will not make sense since the AI will not be able to recall the last few messages of the conversation with the user or group

This method will return a Session Object upon a successful request

Session Creation Limit

Depending on your subscription, there are a limited amount of sessions that you can create. Each session lasts around for 3 hours but the usage for each session contains no limit.

For example, your subscription may only support "100 Monthly Lydia Sessions" which means that you can only create 100 sessions per month and that limitation only resets after a billing cycle (Both paid and free)

Endpoint Parameters

Parameter Name	Default Value	Required	Description
language	en	False	The default language that the AI will try to base the conversation in, can be ISO-639-1 or a language name (Eg; English, Español)

Example Success Response

{
  "success": true,
  "response_code": 200,
  "results": {
    "session_id": "46db504f80a9eadd0fbec43ff4f75690962242b5c57fb23f6e4f2a23423bcab8",
    "language": "en",
    "available": true,
    "expires": 1581899765
  }
}

Session Object Structure

Name	Type	Description
session_id	`string`	The ID of the session that must be used for requests like "Think Thought"
language	`string`	The ISO 639-1 Language code that this session is based in
available	`boolean`	Indicates if this session is available or not. A session can be unavailable if it has expired or a session error raises
expires	`integer`	The Unix Timestamp for when this session will expire

Invalid Language Code Response

This response is given when the parameter target_language contains an invalid value.

{
  "success": false,
  "response_code": 400,
  "error": {
    "error_code": 7,
    "type": "CLIENT",
    "message": "The given language code is not a valid ISO 639-1 Language Code"
  }
}