People

Lists all Person objects.

get

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

Responses

200

Success

application/json

Response of a List People request.

countinteger · int32Optional

Total number of Person objects.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous response.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous response.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is equivalent to the HTTP status code.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/memori/v2/People/{strSessionID}

HTTPcURLJavaScriptPython

GET /memori/v2/People/{strSessionID} HTTP/1.1
Accept: */*

200

Success

{
  "count": 1,
  "people": [
    {
      "personID": "text",
      "personType": "text",
      "name": "text",
      "information": "text",
      "pin": "text",
      "tag": "text",
      "creationTimestamp": "2026-03-07T11:53:49.109Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2026-03-07T11:53:49.109Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-07T11:53:49.109Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Lists Person 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 Person object to list

howManyinteger · int32Required

The number of the Person objects to list

Responses

200

Success

application/json

Response of a List People request.

countinteger · int32Optional

Total number of Person objects.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous response.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous response.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is equivalent to the HTTP status code.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/memori/v2/People/{strSessionID}/{from}/{howMany}

HTTPcURLJavaScriptPython

GET /memori/v2/People/{strSessionID}/{from}/{howMany} HTTP/1.1
Accept: */*

200

Success

{
  "count": 1,
  "people": [
    {
      "personID": "text",
      "personType": "text",
      "name": "text",
      "information": "text",
      "pin": "text",
      "tag": "text",
      "creationTimestamp": "2026-03-07T11:53:49.109Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2026-03-07T11:53:49.109Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-07T11:53:49.109Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of a Person object.

get

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

strPersonIDstringRequired

The Person object ID

Responses

200

Success

application/json

Response of a Get Person request.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous response.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous response.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is equivalent to the HTTP status code.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/memori/v2/Person/{strSessionID}/{strPersonID}

HTTPcURLJavaScriptPython

GET /memori/v2/Person/{strSessionID}/{strPersonID} HTTP/1.1
Accept: */*

200

Success

{
  "person": {
    "personID": "text",
    "personType": "text",
    "name": "text",
    "information": "text",
    "pin": "text",
    "tag": "text",
    "creationTimestamp": "2026-03-07T11:53:49.109Z",
    "creationSessionID": "text",
    "lastChangeTimestamp": "2026-03-07T11:53:49.109Z",
    "lastChangeSessionID": "text"
  },
  "requestID": 1,
  "requestDateTime": "2026-03-07T11:53:49.109Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes an existing Person object.

delete

This API requires a Giver session. Only Receiver objects can be removed.

Path parameters

strSessionIDstringRequired

The session ID

strPersonIDstringRequired

The Person object ID

Responses

200

Success

application/json

Base response.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous response.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous response.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is equivalent to the HTTP status code.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

delete

/memori/v2/Person/{strSessionID}/{strPersonID}

HTTPcURLJavaScriptPython

DELETE /memori/v2/Person/{strSessionID}/{strPersonID} HTTP/1.1
Accept: */*

200

Success

{
  "requestID": 1,
  "requestDateTime": "2026-03-07T11:53:49.109Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Updates an existing Person 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

strPersonIDstringRequired

The Person object ID

Body

application/json

Specifications for an Update Person request.

personIDstring · nullableOptional

Person object ID.

personTypestring · nullableOptional

Person type, e.g. Giver or Receiver. Required during Add operations.

namestring · nullableOptional

Person name. May be Null only when the Person object is created by the Dialog State Machine and the name has not been set yet.

informationstring · nullableOptional

Person information. Currently this is a free (unprocessed) text.

pinstring · nullableOptional

Person PIN. Must be a code between 000000 and 999999. May be Null only when the Person object is created by the Dialog State Machine and the PIN has not been set yet. Required during Add operations.

tagstring · nullableOptional

Person tag. Can be any publicly visible string that the person recognizes as distinctive. Typically it is an emoji symbol, but could also be an RFID code or something else.

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

Base response.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous response.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous response.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is equivalent to the HTTP status code.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

patch

/memori/v2/Person/{strSessionID}/{strPersonID}

HTTPcURLJavaScriptPython

PATCH /memori/v2/Person/{strSessionID}/{strPersonID} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "personID": "text",
  "personType": "text",
  "name": "text",
  "information": "text",
  "pin": "text",
  "tag": "text",
  "creationTimestamp": "2026-03-07T11:53:49.109Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2026-03-07T11:53:49.109Z",
  "lastChangeSessionID": "text"
}

200

Success

{
  "requestID": 1,
  "requestDateTime": "2026-03-07T11:53:49.109Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Adds a new Person object.

post

This API requires a Giver session. Only Receiver objects can be created with this API, the Giver object is always created by the Dialog State Machine.

Path parameters

strSessionIDstringRequired

The session ID

Body

application/json

Specifications for an Add Person request.

personIDstring · nullableOptional

Person object ID.

personTypestring · nullableOptional

Person type, e.g. Giver or Receiver. Required during Add operations.

namestring · nullableOptional

Person name. May be Null only when the Person object is created by the Dialog State Machine and the name has not been set yet.

informationstring · nullableOptional

Person information. Currently this is a free (unprocessed) text.

pinstring · nullableOptional

Person PIN. Must be a code between 000000 and 999999. May be Null only when the Person object is created by the Dialog State Machine and the PIN has not been set yet. Required during Add operations.

tagstring · nullableOptional

Person tag. Can be any publicly visible string that the person recognizes as distinctive. Typically it is an emoji symbol, but could also be an RFID code or something else.

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

Response of an Add Person request.

personIDstring · nullableOptional

Person object ID.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous response.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous response.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is equivalent to the HTTP status code.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

post

/memori/v2/Person/{strSessionID}

HTTPcURLJavaScriptPython

POST /memori/v2/Person/{strSessionID} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "personID": "text",
  "personType": "text",
  "name": "text",
  "information": "text",
  "pin": "text",
  "tag": "text",
  "creationTimestamp": "2026-03-07T11:53:49.109Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2026-03-07T11:53:49.109Z",
  "lastChangeSessionID": "text"
}

200

Success

{
  "personID": "text",
  "requestID": 1,
  "requestDateTime": "2026-03-07T11:53:49.109Z",
  "resultCode": 1,
  "resultMessage": "text"
}