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

Asset

PreviousAnalysisNextBadge

Uploads a file and creates a new Asset object to access it.

post
Path parameters
strTokenstringRequired

The login token

strMemoriIDstringOptional

The optional ID of a Memori object the Asset belongs to

strEngineMemoryIDstringOptional

The optional ID of an Engine Memory object the Asset belongs to

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

Success

{
  "asset": {
    "assetID": "text",
    "assetURL": "text",
    "mimeType": "text",
    "originalFileName": "text",
    "memoriID": "text",
    "engineMemoryID": "text",
    "creationTimestamp": "2025-06-07T18:40:58.492Z",
    "lastChangeTimestamp": "2025-06-07T18:40:58.492Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T18:40:58.492Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of an Asset object.

get
Path parameters
strTokenstringRequired

The login token

fileNamestringRequired

Name of the Asset file

Responses
200
Success
get
GET /api/v2/AssetDetails/{strToken}/{fileName} HTTP/1.1
Host: 
Accept: */*
200

Success

{
  "asset": {
    "assetID": "text",
    "assetURL": "text",
    "mimeType": "text",
    "originalFileName": "text",
    "memoriID": "text",
    "engineMemoryID": "text",
    "creationTimestamp": "2025-06-07T18:40:58.492Z",
    "lastChangeTimestamp": "2025-06-07T18:40:58.492Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T18:40:58.492Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets a list of Asset objects owned the currently logged in User.

get
Path parameters
strTokenstringRequired

The login token

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

Success

{
  "assets": [
    {
      "assetID": "text",
      "assetURL": "text",
      "mimeType": "text",
      "originalFileName": "text",
      "memoriID": "text",
      "engineMemoryID": "text",
      "creationTimestamp": "2025-06-07T18:40:58.492Z",
      "lastChangeTimestamp": "2025-06-07T18:40:58.492Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T18:40:58.492Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Downloads a file from an old Cloud asset file URL, such as ```cloud://<path>/<assetID>.<ext>```.

get
Path parameters
assetIDstringRequired

ID of the old Cloud asset file

Responses
200
Success
get
GET /api/v1/CloudAsset/{assetID} HTTP/1.1
Host: 
Accept: */*
200

Success

No content

Downloads a file from an old asset file URL, such as ```/api/v1/memoriai/memory/media/cloud/<path>/<assetID>.<ext>```.

get
Path parameters
assetIDstringRequired

ID of the old asset file

Responses
200
Success
get
GET /api/v1/memoriai/memory/media/cloud/{assetID} HTTP/1.1
Host: 
Accept: */*
200

Success

No content

Downloads a file from an old asset file URL, such as ```/api/v1/memoriai/memory/<memoryID>/media/cloud/<path>/<assetID>.<ext>```.

get
Path parameters
strMemoryIDstringRequired

ID of the engine Memory object

assetIDstringRequired

ID of the old asset file

Responses
200
Success
get
GET /api/v1/memoriai/memory/{strMemoryID}/media/cloud/{assetID} HTTP/1.1
Host: 
Accept: */*
200

Success

No content

Downloads the cover file from an old cover asset URL, sucs as ```/api/v1/memoriai/memori/cover/<memoriID>```.

get
Path parameters
strMemoriIDstringRequired

ID of the engine Memori object

Responses
200
Success
get
GET /api/v1/memoriai/memori/cover/{strMemoriID} HTTP/1.1
Host: 
Accept: */*
200

Success

No content

Downloads the avatar file from an old avatar asset URL, sucs as ```/api/v1/memoriai/memori/avatar/<memoriID>```.

get
Path parameters
strMemoriIDstringRequired

ID of the engine Memori object

Responses
200
Success
get
GET /api/v1/memoriai/memori/avatar/{strMemoriID} HTTP/1.1
Host: 
Accept: */*
200

Success

No content

Downloads a file from an Asset object.

get

The fileName parameter supports specifying a resize format by appending '@{format}' before the extension (e.g., 'assetId@32x32.png'). The following formats are supported:

  • ```favicon``` (16x16)

  • ```16x16```

  • ```32x32```

  • ```180x180```

  • ```192x192```

  • ```300x300```

  • ```512x512```

Path parameters
fileNamestringRequired

Name of the Asset file

strMemoriSessionIDstringOptional

Optional ID of an Engine Memori session

Responses
200
Success
get
GET /api/v2/Asset/{fileName}/{strMemoriSessionID} HTTP/1.1
Host: 
Accept: */*
200

Success

No content

Deletes a file and its corresponding Asset object.

delete
Path parameters
strTokenstringRequired

The login token

fileNamestringRequired

Name of the Asset file

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

Success

{
  "requestID": 1,
  "requestDateTime": "2025-06-07T18:40:58.492Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • POSTUploads a file and creates a new Asset object to access it.
  • GETGets the details of an Asset object.
  • GETGets a list of Asset objects owned the currently logged in User.
  • GETDownloads a file from an old Cloud asset file URL, such as ```cloud://<path>/<assetID>.<ext>```.
  • GETDownloads a file from an old asset file URL, such as ```/api/v1/memoriai/memory/media/cloud/<path>/<assetID>.<ext>```.
  • GETDownloads a file from an old asset file URL, such as ```/api/v1/memoriai/memory/<memoryID>/media/cloud/<path>/<assetID>.<ext>```.
  • GETDownloads the cover file from an old cover asset URL, sucs as ```/api/v1/memoriai/memori/cover/<memoriID>```.
  • GETDownloads the avatar file from an old avatar asset URL, sucs as ```/api/v1/memoriai/memori/avatar/<memoriID>```.
  • GETDownloads a file from an Asset object.
  • DELETEDeletes a file and its corresponding Asset object.
  • PATCHUpdates an Asset object.

Updates an Asset object.

patch
Path parameters
strTokenstringRequired

The login token

fileNamestringRequired

Name of the Asset file

Body

Specifications of an Asset object.

assetIDstring | nullableOptional

Asset ID. Unique and assigned by the system. Returned during Upload operations. Ignored in other cases.

assetURLstring | nullableOptional

Public URL of the Asset file. Unique and assigned by the system. Returned during Upload operations. Ignored in other cases.

mimeTypestring | nullableOptional

Extrapolated MIME type. Returned during Upload operations. Ignored in other cases.

originalFileNamestring | nullableOptional

Original name of the uploaded file, without the extension. Returned during Upload operations. Used during Update operations.

memoriIDstring | nullableOptional

Optional ID of the Memori object this Asset belongs to. May be empty for assets not belonging to a Memori object. Returned during Upload operations. Ignored in other cases.

engineMemoryIDstring | nullableOptional

Optional ID of the Memory object on the Memori Engine. May be empty for public assets. Returned during Upload operations. Used during Update operations. To clear this property during an Update operation set it to a single dash character ("-").

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/Asset/{strToken}/{fileName} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "assetID": "text",
  "assetURL": "text",
  "mimeType": "text",
  "originalFileName": "text",
  "memoriID": "text",
  "engineMemoryID": "text",
  "creationTimestamp": "2025-06-07T18:40:58.492Z",
  "lastChangeTimestamp": "2025-06-07T18:40:58.492Z"
}
200

Success

{
  "asset": {
    "assetID": "text",
    "assetURL": "text",
    "mimeType": "text",
    "originalFileName": "text",
    "memoriID": "text",
    "engineMemoryID": "text",
    "creationTimestamp": "2025-06-07T18:40:58.492Z",
    "lastChangeTimestamp": "2025-06-07T18:40:58.492Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T18:40:58.492Z",
  "resultCode": 1,
  "resultMessage": "text"
}