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

CustomDictionary

PreviousCorrelationPairsNextDialog

Lists all Custom Word objects.

get

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

Responses
200
Success
application/json
get
GET /memori/v2/CustomWords/{strSessionID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "count": 1,
  "customWords": [
    {
      "customWordID": "text",
      "word": "text",
      "definition": "text",
      "creationTimestamp": "2025-06-07T11:51:31.628Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2025-06-07T11:51:31.628Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T11:51:31.628Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Lists Custom Word objects with pagination.

get

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

frominteger · int32Required

The 0-based index of the first Custom Word to list

howManyinteger · int32Required

The number of the Custom Word to list

Responses
200
Success
application/json
get
GET /memori/v2/CustomWords/{strSessionID}/{from}/{howMany} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "count": 1,
  "customWords": [
    {
      "customWordID": "text",
      "word": "text",
      "definition": "text",
      "creationTimestamp": "2025-06-07T11:51:31.628Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2025-06-07T11:51:31.628Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T11:51:31.628Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of a Custom Word object.

get

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strCustomWordIDstringRequired

The Custom Word object ID

Responses
200
Success
application/json
get
GET /memori/v2/CustomWord/{strSessionID}/{strCustomWordID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "customWord": {
    "customWordID": "text",
    "word": "text",
    "definition": "text",
    "creationTimestamp": "2025-06-07T11:51:31.628Z",
    "creationSessionID": "text",
    "lastChangeTimestamp": "2025-06-07T11:51:31.628Z",
    "lastChangeSessionID": "text"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T11:51:31.628Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes an existing Custom Word object.

delete

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strCustomWordIDstringRequired

The Custom Word object ID

Responses
200
Success
application/json
delete
DELETE /memori/v2/CustomWord/{strSessionID}/{strCustomWordID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-07T11:51:31.628Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • GETLists all Custom Word objects.
  • GETLists Custom Word objects with pagination.
  • GETGets the details of a Custom Word object.
  • DELETERemoves an existing Custom Word object.
  • PATCHUpdates an existing Custom Word object.
  • POSTAdds a new Custom Word object.

Updates an existing Custom Word object.

patch

This API requires a Giver session. Only the Definition field is considered for update. To change the Word field a new Custom Word must be added and the existing must be removed.

Path parameters
strSessionIDstringRequired

The session ID

strCustomWordIDstringRequired

The Custom Word object ID

Body
customWordIDstring | nullableOptional

Custom Word object ID.

wordstring | nullableOptional

Custom Word.

definitionstring | nullableOptional

Definition of the Custom Word, in terms of sums and subtractions of existing words or custom words. The syntax for a Custom Word definition is as follows: word1 [+-] word2 [+-] word3... If the operator is omitted it is assumed to be the last specified from the left, and if no operator has been specified it is assumed to be the sum. E.g.: alpha beta gamma is equivalent to alpha + beta + gamma alpha beta - gamma delta is equivalent to alpha + beta - gamma - delta

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Always present when reading/receiving an object, ignored when writing/sending an object.

creationSessionIDstring | nullableOptional

ID of the session that created this object.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Always present when reading/receiving an object, ignored when writing/sending an object.

lastChangeSessionIDstring | nullableOptional

ID of the latest session that changed this object.

Responses
200
Success
application/json
patch
PATCH /memori/v2/CustomWord/{strSessionID}/{strCustomWordID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 209

{
  "customWordID": "text",
  "word": "text",
  "definition": "text",
  "creationTimestamp": "2025-06-07T11:51:31.628Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2025-06-07T11:51:31.628Z",
  "lastChangeSessionID": "text"
}
200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-07T11:51:31.628Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Adds a new Custom Word object.

post

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

Body
customWordIDstring | nullableOptional

Custom Word object ID.

wordstring | nullableOptional

Custom Word.

definitionstring | nullableOptional

Definition of the Custom Word, in terms of sums and subtractions of existing words or custom words. The syntax for a Custom Word definition is as follows: word1 [+-] word2 [+-] word3... If the operator is omitted it is assumed to be the last specified from the left, and if no operator has been specified it is assumed to be the sum. E.g.: alpha beta gamma is equivalent to alpha + beta + gamma alpha beta - gamma delta is equivalent to alpha + beta - gamma - delta

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Always present when reading/receiving an object, ignored when writing/sending an object.

creationSessionIDstring | nullableOptional

ID of the session that created this object.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Always present when reading/receiving an object, ignored when writing/sending an object.

lastChangeSessionIDstring | nullableOptional

ID of the latest session that changed this object.

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

{
  "customWordID": "text",
  "word": "text",
  "definition": "text",
  "creationTimestamp": "2025-06-07T11:51:31.628Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2025-06-07T11:51:31.628Z",
  "lastChangeSessionID": "text"
}
200

Success

{
  "customWordID": "text",
  "requestID": 1,
  "requestDateTime": "2025-06-07T11:51:31.628Z",
  "resultCode": 1,
  "resultMessage": "text"
}