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. Backend

User

PreviousTenantNextModels

Gets the details of the currently logged in User object.

get
Path parameters
strTokenstringRequired

The login token

Responses
200
Success
application/json
get
GET /api/v2/User/{strToken} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of a User object.

get

Access to User objects different than the current logged in user is granted only to administrative users.

Path parameters
strTokenstringRequired

The login token

strUserIDstringRequired

The User object ID

Responses
200
Success
application/json
get
GET /api/v2/User/{strToken}/{strUserID} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Deletes a User object.

delete

Access to User objects different than the current logged in user is granted only to administrative users.

Path parameters
strTokenstringRequired

The login token

strUserIDstringRequired

The User object ID

Responses
200
Success
application/json
delete
DELETE /api/v2/User/{strToken}/{strUserID} HTTP/1.1
Host: 
Accept: */*
200

Success

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

Gets a list of all the existing User objects.

get

Access to User objects different than the current logged in user is granted only to administrative users.

Path parameters
strTokenstringRequired

The login token

Responses
200
Success
application/json
get
GET /api/v2/Users/{strToken} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "users": [
    {
      "tenant": "text",
      "userID": "text",
      "userName": "text",
      "password": "text",
      "newPassword": "text",
      "eMail": "text",
      "avatarURL": "text",
      "avatar3DURL": "text",
      "avatar3DURLType": "text",
      "dontSendInvitationEmail": true,
      "referral": "text",
      "couponCode": "text",
      "newsletterSubscribed": true,
      "notificationPrefs": [
        {
          "chatLogExtractionPeriod": "text",
          "chatLogExtractionMinLines": 1,
          "memoriID": "text"
        }
      ],
      "admin": true,
      "superAdmin": true,
      "numMemori": 1,
      "maxMemori": 1,
      "monthSessions": 1,
      "monthValidSessions": 1,
      "monthDeepThoughtValidSessions": 1,
      "maxFreeSessions": 1,
      "nonFreeSessionCost": 1,
      "monthCompletions": 1,
      "monthDeepThoughtCompletions": 1,
      "monthImportedSize": 1,
      "maxCompletions": 1,
      "maxImportSize": 1,
      "paying": true,
      "enableMemoriCreation": true,
      "enableBoardOfExperts": true,
      "enableDCMIntegration": true,
      "enableBadges": true,
      "enableDeepThought": true,
      "enableVirtualSpaces": true,
      "birthDate": "2025-06-07T17:49:00.841Z",
      "age": 1,
      "tnCAndPPAccepted": true,
      "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
      "pAndCUAccepted": true,
      "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
      "verificationCode": "text",
      "flowID": "text",
      "creationTimestamp": "2025-06-07T17:49:00.841Z",
      "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
    }
  ],
  "count": 1,
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets a paginated list of the existing User objects.

get

Access to User objects different than the current logged in user is granted only to administrative users.

Path parameters
strTokenstringRequired

The login token

frominteger · int32Required

The index of the starting user to get

howManyinteger · int32Required

How many users to get

Responses
200
Success
application/json
get
GET /api/v2/Users/{strToken}/{from}/{howMany} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "users": [
    {
      "tenant": "text",
      "userID": "text",
      "userName": "text",
      "password": "text",
      "newPassword": "text",
      "eMail": "text",
      "avatarURL": "text",
      "avatar3DURL": "text",
      "avatar3DURLType": "text",
      "dontSendInvitationEmail": true,
      "referral": "text",
      "couponCode": "text",
      "newsletterSubscribed": true,
      "notificationPrefs": [
        {
          "chatLogExtractionPeriod": "text",
          "chatLogExtractionMinLines": 1,
          "memoriID": "text"
        }
      ],
      "admin": true,
      "superAdmin": true,
      "numMemori": 1,
      "maxMemori": 1,
      "monthSessions": 1,
      "monthValidSessions": 1,
      "monthDeepThoughtValidSessions": 1,
      "maxFreeSessions": 1,
      "nonFreeSessionCost": 1,
      "monthCompletions": 1,
      "monthDeepThoughtCompletions": 1,
      "monthImportedSize": 1,
      "maxCompletions": 1,
      "maxImportSize": 1,
      "paying": true,
      "enableMemoriCreation": true,
      "enableBoardOfExperts": true,
      "enableDCMIntegration": true,
      "enableBadges": true,
      "enableDeepThought": true,
      "enableVirtualSpaces": true,
      "birthDate": "2025-06-07T17:49:00.841Z",
      "age": 1,
      "tnCAndPPAccepted": true,
      "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
      "pAndCUAccepted": true,
      "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
      "verificationCode": "text",
      "flowID": "text",
      "creationTimestamp": "2025-06-07T17:49:00.841Z",
      "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
    }
  ],
  "count": 1,
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • POSTTries a login with the specified credentials and returns a login token if successful.
  • POSTLogs out the User.
  • GETGets the details of the currently logged in User object.
  • POSTCreates a new user.
  • GETGets the details of a User object.
  • DELETEDeletes a User object.
  • PATCHUpdates the details of a User object (including its password).
  • GETGets a list of all the existing User objects.
  • GETGets a paginated list of the existing User objects.
  • POSTReturns a paginated list of User objects filtered by the specified criteria
  • POSTRegisters a new user.
  • POSTRe-sends the verification code to confirm a pending User registration.
  • POSTConfirms the registration of a User and performs a Login.
  • POSTResets a User's password.
  • POSTConfirms the password reset of a User and performs a Login.
  • POSTRecovers a User's name and sends it to their configured e-mail.

Logs out the User.

post
Path parameters
strTokenstringRequired

The login token

Responses
200
Success
application/json
post
POST /api/v2/Logout/{strToken} HTTP/1.1
Host: 
Accept: */*
200

Success

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

Tries a login with the specified credentials and returns a login token if successful.

post
Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/Login HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

{
  "token": "text",
  "flowID": "text",
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Creates a new user.

post

Creation of User objects is granted only to administrative users.

Path parameters
strTokenstringRequired

The login token

Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/User/{strToken} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

{
  "temporaryPassword": "text",
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Updates the details of a User object (including its password).

patch

Access to User objects different than the current logged in user is granted only to administrative users.

Path parameters
strTokenstringRequired

The login token

strUserIDstringRequired

The User object ID

Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
patch
PATCH /api/v2/User/{strToken}/{strUserID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

{
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Returns a paginated list of User objects filtered by the specified criteria

post
Path parameters
strTokenstringRequired

The login token

Body
periodFromstring · date-time | nullableOptional

The starting date of the filter

periodTostring · date-time | nullableOptional

The end date of the filter

tenantNamestring | nullableOptional

The tenant name to filter the users.

textstring | nullableOptional

A search query to filter the users

numberOfResultsinteger · int32 | nullableOptional

Optional number of results. If omitted defaults to 5.

startFrominteger · int32 | nullableOptional

Optional initial result index, 0-based. If omitted defaults to 0. Used for Search, Filter Memories and Memory Hints. Ignored for Random picking.

orderBystring | nullableOptional

Optional order by field. If omitted defaults to CreationDate. Can be one of the following: CreationDateAscending: the results are ordered by creation date in ascending order. CreationDateDescending: the results are ordered by creation date in descending order. MemoriCountAscending: the results are ordered by Memori count in ascending order. MemoriCountDescending: the results are ordered by Memori count in descending order. MonthCompletionsAscending: the results are ordered by month completions in ascending order. MonthCompletionsDescending: the results are ordered by month completions in descending order. MonthImportSizeAscending: the results are ordered by month import size in ascending order. MonthImportSizeDescending: the results are ordered by month import size in descending order.

Responses
200
Success
application/json
post
POST /api/v2/FilterUsers/{strToken} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "periodFrom": "2025-06-07T17:49:00.841Z",
  "periodTo": "2025-06-07T17:49:00.841Z",
  "tenantName": "text",
  "text": "text",
  "numberOfResults": 1,
  "startFrom": 1,
  "orderBy": "text"
}
200

Success

{
  "users": [
    {
      "tenant": "text",
      "userID": "text",
      "userName": "text",
      "password": "text",
      "newPassword": "text",
      "eMail": "text",
      "avatarURL": "text",
      "avatar3DURL": "text",
      "avatar3DURLType": "text",
      "dontSendInvitationEmail": true,
      "referral": "text",
      "couponCode": "text",
      "newsletterSubscribed": true,
      "notificationPrefs": [
        {
          "chatLogExtractionPeriod": "text",
          "chatLogExtractionMinLines": 1,
          "memoriID": "text"
        }
      ],
      "admin": true,
      "superAdmin": true,
      "numMemori": 1,
      "maxMemori": 1,
      "monthSessions": 1,
      "monthValidSessions": 1,
      "monthDeepThoughtValidSessions": 1,
      "maxFreeSessions": 1,
      "nonFreeSessionCost": 1,
      "monthCompletions": 1,
      "monthDeepThoughtCompletions": 1,
      "monthImportedSize": 1,
      "maxCompletions": 1,
      "maxImportSize": 1,
      "paying": true,
      "enableMemoriCreation": true,
      "enableBoardOfExperts": true,
      "enableDCMIntegration": true,
      "enableBadges": true,
      "enableDeepThought": true,
      "enableVirtualSpaces": true,
      "birthDate": "2025-06-07T17:49:00.841Z",
      "age": 1,
      "tnCAndPPAccepted": true,
      "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
      "pAndCUAccepted": true,
      "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
      "verificationCode": "text",
      "flowID": "text",
      "creationTimestamp": "2025-06-07T17:49:00.841Z",
      "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
    }
  ],
  "count": 1,
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Registers a new user.

post

If registration succeeds, the User receives a verification code via e-mail. The code must be sent via the UserConfirm API, passing the same User object sent to this API with the addition of the verification code.

Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/User HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

{
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Re-sends the verification code to confirm a pending User registration.

post
Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/ResendVerificationCode HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

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

Confirms the registration of a User and performs a Login.

post
Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/UserConfirm HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

{
  "token": "text",
  "flowID": "text",
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Resets a User's password.

post

If found, the User receives a verification code via e-mail. The code must be sent via the ResetConfirm API, passing the same User object sent to this API with the addition of the verification code and the new password.

Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/ResetPassword HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

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

Confirms the password reset of a User and performs a Login.

post
Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/ResetConfirm HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

{
  "token": "text",
  "flowID": "text",
  "user": {
    "tenant": "text",
    "userID": "text",
    "userName": "text",
    "password": "text",
    "newPassword": "text",
    "eMail": "text",
    "avatarURL": "text",
    "avatar3DURL": "text",
    "avatar3DURLType": "text",
    "dontSendInvitationEmail": true,
    "referral": "text",
    "couponCode": "text",
    "newsletterSubscribed": true,
    "notificationPrefs": [
      {
        "chatLogExtractionPeriod": "text",
        "chatLogExtractionMinLines": 1,
        "memoriID": "text"
      }
    ],
    "admin": true,
    "superAdmin": true,
    "numMemori": 1,
    "maxMemori": 1,
    "monthSessions": 1,
    "monthValidSessions": 1,
    "monthDeepThoughtValidSessions": 1,
    "maxFreeSessions": 1,
    "nonFreeSessionCost": 1,
    "monthCompletions": 1,
    "monthDeepThoughtCompletions": 1,
    "monthImportedSize": 1,
    "maxCompletions": 1,
    "maxImportSize": 1,
    "paying": true,
    "enableMemoriCreation": true,
    "enableBoardOfExperts": true,
    "enableDCMIntegration": true,
    "enableBadges": true,
    "enableDeepThought": true,
    "enableVirtualSpaces": true,
    "birthDate": "2025-06-07T17:49:00.841Z",
    "age": 1,
    "tnCAndPPAccepted": true,
    "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "pAndCUAccepted": true,
    "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
    "verificationCode": "text",
    "flowID": "text",
    "creationTimestamp": "2025-06-07T17:49:00.841Z",
    "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T17:49:00.841Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Recovers a User's name and sends it to their configured e-mail.

post
Body

Specifications of a User object.

tenantstring | nullableOptional

Name of the Tenant this user is associated to. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

userIDstring | nullableOptional

User ID. Unique and assigned by the system. Returned during Login and Get operations. Ignored in other cases.

userNamestring | nullableOptional

User name. Must be unique. Required during Login and Registration operations. Returned during Get operations. Ignored in other cases.

passwordstring | nullableOptional

Password. Required during Login and Registration operations. Also required during Update operations if NewPassword is specified. Ignored in other cases.

newPasswordstring | nullableOptional

New password. Used during Update and Login operations, if the user wants or must change password. Ignored in other cases.

eMailstring | nullableOptional

E-mail address. Required during Registration operations. Used during Update operations. May be used as an alternative to UserName during Login operations. Returned during Get operations. The address is checked via a verification code.

avatarURLstring | nullableOptional

URL of the avatar image representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLstring | nullableOptional

URL of the avatar 3D model representing the User. May be provided during Registration and Update operations. Returned during Login and Get operations.

avatar3DURLTypestring | nullableOptional

Additional information about the avatar 3D model URL, e.g. if it's a head-only, full-body avatar, custom model etc. Sample possible values are: readyplayerme: the avatar 3D URL points a half-body ReadyPlayerMe GLB model readyplayerme-full: the avatar 3D URL points a full-body ReadyPlayerMe GLB model customglb: the avatar 3D URL points to a custom GLB model

dontSendInvitationEmailboolean | nullableOptional

If True during a Creation operation, the automatic invitation e-mail is not sent, and the temporary password is returned as part of the operation response. Used during Creation operations. Ignored in other cases.

referralstring | nullableOptional

Optional referral URL from which the User reached the registration page.

couponCodestring | nullableOptional

Optional coupon code used by the User during Registration.

newsletterSubscribedboolean | nullableOptional

True if the e-mail address is subscribed to the newsletter. Used during Registration and Update operations. Returned during Get operations.

adminboolean | nullableOptional

True if the User is an administrator, i.e. can administer the tenant they are part of. Used during Creation and Update operations by a super administrator. Returned during Login and Get operations.

superAdminboolean | nullableOptional

True if the User is a super administrator, i.e. can administer all tenants. Returned during Login and Get operations. Ignored in other cases.

numMemoriinteger · int32 | nullableOptional

Current number of Memori objects belonging to this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxMemoriinteger · int32 | nullableOptional

Maximum number of Memori objects this User can create. If 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

monthSessionsinteger · int32 | nullableOptional

Number of session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

monthDeepThoughtValidSessionsinteger · int32 | nullableOptional

Number of valid session in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user themself.

maxFreeSessionsinteger · int32 | nullableOptional

Maximum number of free Memori sessions this User can open per month. if 0> it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

nonFreeSessionCostnumber · double | nullableOptional

Cost of each new session above the max free sessions threshold.

monthCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthDeepThoughtCompletionsinteger · int32 | nullableOptional

Number of completions in the current month for this User, with Deep Thought enabled. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

monthImportedSizeinteger · int64 | nullableOptional

Number of characters imported in the current month for this User. Returned during Get and Login operations. Ignored in other cases. Visible only to administrators and the user itself.

maxCompletionsinteger · int32 | nullableOptional

Maximum number of completions for this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

maxImportSizeinteger · int64 | nullableOptional

Maximum number of characters that can imported be by this User per month. if 0 it means unlimited. Used during Creation and Update operations by a super administrator. Returned during Get and Login operations.

payingboolean | nullableOptional

If True means this User has an actual payment contract in effect and non-free sessions (i.e. sessions above the max free session threshold) can be performed.

enableMemoriCreationboolean | nullableOptional

True if the User can create new Memori objects. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBoardOfExpertsboolean | nullableOptional

True if the User can access the Board of Experts feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDCMIntegrationboolean | nullableOptional

True if the User access the DCM integration feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableBadgesboolean | nullableOptional

If True this User accepts DCM outcomes and consequently can receive badges in the Open Badge format. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableDeepThoughtboolean | nullableOptional

True if the User can access the Deep Thought feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

enableVirtualSpacesboolean | nullableOptional

True if the User can access the Virtual Spaces feature. Used during Creation and Update operations by an administrator. Returned during Get and Login operations.

birthDatestring · date-time | nullableOptional

User date of birth. Necessary of age-restricted features, such as enabling completions or accessing NSFW content. Used during Registration and Update operations. Returned during Get operations.

ageinteger · int32Optional

Age computed from the birth date. Returned during Get operations. Ignored in other cases.

tnCAndPPAcceptedboolean | nullableOptional

Terms & Conditions and Privacy Policy acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False all operations that imply a change are blocked. Mandatory during Registration. Used during Update operations. Returned during Get operations.

tnCAndPPAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Terms & Conditions and Privacy Policy. Returned during Get operations. Ignored in other cases.

pAndCUAcceptedboolean | nullableOptional

Profiling & Commercial Use acceptance flag. May be reset to False in case of T. & C. and/or P. P. change. When False features that require profiling and may imply commercial communication to the User (e.g. Deep Thought) are disabled. Used during Registration and Update operations. Returned during Get operations.

pAndCUAcceptanceDatestring · date-time | nullableOptional

Date of acceptance of Profiling & Commercial Use. Returned during Get operations. Ignored in other cases.

verificationCodestring | nullableOptional

Verification code. May be required during Login or Registration operations if the User has MFA enabled or if a verification code has been sent. Ignored in other cases

flowIDstring | nullableOptional

Login flow ID. May be required during a Login operation if a previous Login or Registration operation did not succeed due to a challenge (password change, verification code etc.). Ignored in other cases.

creationTimestampstring · date-time | nullableOptional

Timestamp of creation. Returned during Get operations. Ignored in other cases.

lastChangeTimestampstring · date-time | nullableOptional

Timestamp of latest change. Returned during Get operations. Ignored in other cases.

Responses
200
Success
application/json
post
POST /api/v2/RecoverUserName HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 1164

{
  "tenant": "text",
  "userID": "text",
  "userName": "text",
  "password": "text",
  "newPassword": "text",
  "eMail": "text",
  "avatarURL": "text",
  "avatar3DURL": "text",
  "avatar3DURLType": "text",
  "dontSendInvitationEmail": true,
  "referral": "text",
  "couponCode": "text",
  "newsletterSubscribed": true,
  "notificationPrefs": [
    {
      "chatLogExtractionPeriod": "text",
      "chatLogExtractionMinLines": 1,
      "memoriID": "text"
    }
  ],
  "admin": true,
  "superAdmin": true,
  "numMemori": 1,
  "maxMemori": 1,
  "monthSessions": 1,
  "monthValidSessions": 1,
  "monthDeepThoughtValidSessions": 1,
  "maxFreeSessions": 1,
  "nonFreeSessionCost": 1,
  "monthCompletions": 1,
  "monthDeepThoughtCompletions": 1,
  "monthImportedSize": 1,
  "maxCompletions": 1,
  "maxImportSize": 1,
  "paying": true,
  "enableMemoriCreation": true,
  "enableBoardOfExperts": true,
  "enableDCMIntegration": true,
  "enableBadges": true,
  "enableDeepThought": true,
  "enableVirtualSpaces": true,
  "birthDate": "2025-06-07T17:49:00.841Z",
  "age": 1,
  "tnCAndPPAccepted": true,
  "tnCAndPPAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "pAndCUAccepted": true,
  "pAndCUAcceptanceDate": "2025-06-07T17:49:00.841Z",
  "verificationCode": "text",
  "flowID": "text",
  "creationTimestamp": "2025-06-07T17:49:00.841Z",
  "lastChangeTimestamp": "2025-06-07T17:49:00.841Z"
}
200

Success

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