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

ExpertReferences

PreviousEventLogsNextFunctions

Lists all Expert Reference objects.

get
Path parameters
strSessionIDstringRequired

The session ID

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

Success

{
  "count": 1,
  "experts": [
    {
      "expertID": "text",
      "name": "text",
      "description": "text",
      "default": true,
      "expertMemoriID": "text",
      "expertPassword": "text",
      "expertBaseURL": "text",
      "creationTimestamp": "2025-06-07T17:49:00.841Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2025-06-07T17:49:00.841Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Lists Expert Reference objects with pagination.

get
Path parameters
strSessionIDstringRequired

The session ID

frominteger · int32Required

The 0-based index of the first Expert Reference object to list

howManyinteger · int32Required

The number of the Expert Reference objects to list

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

Success

{
  "count": 1,
  "experts": [
    {
      "expertID": "text",
      "name": "text",
      "description": "text",
      "default": true,
      "expertMemoriID": "text",
      "expertPassword": "text",
      "expertBaseURL": "text",
      "creationTimestamp": "2025-06-07T17:49:00.841Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2025-06-07T17:49:00.841Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of an Expert Reference object.

get
Path parameters
strSessionIDstringRequired

The session ID

strExpertReferenceIDstringRequired

The Expert Reference object ID

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

Success

{
  "expert": {
    "expertID": "text",
    "name": "text",
    "description": "text",
    "default": true,
    "expertMemoriID": "text",
    "expertPassword": "text",
    "expertBaseURL": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "creationSessionID": "text",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeSessionID": "text"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes an existing Expert Reference object.

delete

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

strExpertReferenceIDstringRequired

The Expert Reference object ID

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

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • GETLists all Expert Reference objects.
  • GETLists Expert Reference objects with pagination.
  • GETGets the details of an Expert Reference object.
  • DELETERemoves an existing Expert Reference object.
  • PATCHUpdates an existing Expert Reference object.
  • POSTAdds a new Expert Reference object.

Updates an existing Expert Reference object.

patch

This API requires a Giver session. Only non-null (present) fields are considered for update. Null or absent fields are left unaltered.

Path parameters
strSessionIDstringRequired

The session ID

strExpertReferenceIDstringRequired

The Expert Reference object ID

Body

Specifications for an Update Expert Reference request.

expertIDstring | nullableOptional

Expert Reference object ID. Returned during Get operations. Ignored in other cases.

namestring | nullableOptional

Name of the expert. Returned during Get operations. Required during Add operations. Optional during Update operations.

descriptionstring | nullableOptional

Description of the expert, i.e. a list of the expert's skills and knowledge. Returned during Get operations. Required during Add operations. Optional during Update operations.

defaultboolean | nullableOptional

If True, this expert is used when no other expert is competent for the current question. Returned during Get operations. Optional during Add operations. Optional during Update operations.

expertMemoriIDstring | nullableOptional

ID of the expert Memori. Returned during Get operations. Required during Add operations. Optional during Update operations.

expertPasswordstring | nullableOptional

Password of the expert Memori. Required if the chained Memori is private or secret. Optional during Add operations and Update operations. Ignore in other cases.

expertBaseURLstring | nullableOptional

Base URL of a chained Memori, typically https://engine.memori.ai/. Returned during Get operations. Required during Add operations. Optional during Update operations.

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/ExpertReference/{strSessionID}/{strExpertReferenceID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 292

{
  "expertID": "text",
  "name": "text",
  "description": "text",
  "default": true,
  "expertMemoriID": "text",
  "expertPassword": "text",
  "expertBaseURL": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeSessionID": "text"
}
200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Adds a new Expert Reference object.

post

This API requires a Giver session.

Path parameters
strSessionIDstringRequired

The session ID

Body

Specifications for an Add Expert Reference request.

expertIDstring | nullableOptional

Expert Reference object ID. Returned during Get operations. Ignored in other cases.

namestring | nullableOptional

Name of the expert. Returned during Get operations. Required during Add operations. Optional during Update operations.

descriptionstring | nullableOptional

Description of the expert, i.e. a list of the expert's skills and knowledge. Returned during Get operations. Required during Add operations. Optional during Update operations.

defaultboolean | nullableOptional

If True, this expert is used when no other expert is competent for the current question. Returned during Get operations. Optional during Add operations. Optional during Update operations.

expertMemoriIDstring | nullableOptional

ID of the expert Memori. Returned during Get operations. Required during Add operations. Optional during Update operations.

expertPasswordstring | nullableOptional

Password of the expert Memori. Required if the chained Memori is private or secret. Optional during Add operations and Update operations. Ignore in other cases.

expertBaseURLstring | nullableOptional

Base URL of a chained Memori, typically https://engine.memori.ai/. Returned during Get operations. Required during Add operations. Optional during Update operations.

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/ExpertReference/{strSessionID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 292

{
  "expertID": "text",
  "name": "text",
  "description": "text",
  "default": true,
  "expertMemoriID": "text",
  "expertPassword": "text",
  "expertBaseURL": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeSessionID": "text"
}
200

Success

{
  "expertID": "text",
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}