Media

Lists all Medium objects of a Memory.

get

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

Responses

200

Success

application/json

Response of a List Media request.

requestIDinteger · int64Optional

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

requestDateTimestring · date-timeOptional

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

resultCodeinteger · int32Optional

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

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/memori/v2/Media/{strSessionID}/{strMemoryID}

HTTPcURLJavaScriptPython

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

200

Success

{
  "media": [
    {
      "mediumID": "text",
      "url": "text",
      "content": "text",
      "mimeType": "text",
      "title": "text",
      "properties": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "creationTimestamp": "2026-03-07T10:38:47.614Z",
      "creationSessionID": "text",
      "lastChangeTimestamp": "2026-03-07T10:38:47.614Z",
      "lastChangeSessionID": "text"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-07T10:38:47.614Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes all Medium objects from a Memory.

delete

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

Responses

200

Success

application/json

Base response.

requestIDinteger · int64Optional

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

requestDateTimestring · date-timeOptional

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

resultCodeinteger · int32Optional

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

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

delete

/memori/v2/Media/{strSessionID}/{strMemoryID}

HTTPcURLJavaScriptPython

DELETE /memori/v2/Media/{strSessionID}/{strMemoryID} HTTP/1.1
Accept: */*

200

Success

{
  "requestID": 1,
  "requestDateTime": "2026-03-07T10:38:47.614Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the details of a Medium object of a Memory.

get

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

strMediumIDstringRequired

The Medium object ID

Responses

200

Success

application/json

Response of a Get Medium request.

requestIDinteger · int64Optional

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

requestDateTimestring · date-timeOptional

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

resultCodeinteger · int32Optional

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

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID}

HTTPcURLJavaScriptPython

GET /memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID} HTTP/1.1
Accept: */*

200

Success

{
  "medium": {
    "mediumID": "text",
    "url": "text",
    "content": "text",
    "mimeType": "text",
    "title": "text",
    "properties": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "creationTimestamp": "2026-03-07T10:38:47.614Z",
    "creationSessionID": "text",
    "lastChangeTimestamp": "2026-03-07T10:38:47.614Z",
    "lastChangeSessionID": "text"
  },
  "requestID": 1,
  "requestDateTime": "2026-03-07T10:38:47.614Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Removes an existing Medium object from a Memory.

delete

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

strMediumIDstringRequired

The Medium object ID

Responses

200

Success

application/json

Base response.

requestIDinteger · int64Optional

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

requestDateTimestring · date-timeOptional

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

resultCodeinteger · int32Optional

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

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

delete

/memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID}

HTTPcURLJavaScriptPython

DELETE /memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID} HTTP/1.1
Accept: */*

200

Success

{
  "requestID": 1,
  "requestDateTime": "2026-03-07T10:38:47.614Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Updates an existing Medium object of a Memory.

patch

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

Path parameters

strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

strMediumIDstringRequired

The Medium object ID

Body

application/json

mediumIDstring · nullableOptional

Medium object ID.

urlstring · nullableOptional

URL of the Medium. If specified, the Content property must be Null. Use this property to link large amounts of data stored externally. If the amount of data is modest the Content property may be used as an alternative.

contentstring · nullableOptional

Content of the Medium. If specified, the URL property must be Null. Don't use this property to store large amounts of data. Can be used to store limited text for a maximum of 10 KiB. For larger amounts store the data externally and link it via the URL property.

mimeTypestring · nullableOptional

MIME type of the Medium. Required during Add operations.

titlestring · nullableOptional

Title of the Medium.

creationTimestampstring · date-time · nullableOptional

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

creationSessionIDstring · nullableOptional

ID of the session that created this object.

lastChangeTimestampstring · date-time · nullableOptional

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

lastChangeSessionIDstring · nullableOptional

ID of the latest session that changed this object.

Responses

200

Success

application/json

Base response.

requestIDinteger · int64Optional

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

requestDateTimestring · date-timeOptional

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

resultCodeinteger · int32Optional

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

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

patch

/memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID}

HTTPcURLJavaScriptPython

PATCH /memori/v2/Medium/{strSessionID}/{strMemoryID}/{strMediumID} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 282

{
  "mediumID": "text",
  "url": "text",
  "content": "text",
  "mimeType": "text",
  "title": "text",
  "properties": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "creationTimestamp": "2026-03-07T10:38:47.614Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2026-03-07T10:38:47.614Z",
  "lastChangeSessionID": "text"
}

200

Success

{
  "requestID": 1,
  "requestDateTime": "2026-03-07T10:38:47.614Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Adds a new Medium object to a Memory.

post

This API requires a Giver session.

Path parameters

strSessionIDstringRequired

The session ID

strMemoryIDstringRequired

The Memory object ID

Body

application/json

Specifications of a Medium object.

mediumIDstring · nullableOptional

Medium object ID.

urlstring · nullableOptional

URL of the Medium. If specified, the Content property must be Null. Use this property to link large amounts of data stored externally. If the amount of data is modest the Content property may be used as an alternative.

contentstring · nullableOptional

Content of the Medium. If specified, the URL property must be Null. Don't use this property to store large amounts of data. Can be used to store limited text for a maximum of 10 KiB. For larger amounts store the data externally and link it via the URL property.

mimeTypestring · nullableOptional

MIME type of the Medium. Required during Add operations.

titlestring · nullableOptional

Title of the Medium.

creationTimestampstring · date-time · nullableOptional

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

creationSessionIDstring · nullableOptional

ID of the session that created this object.

lastChangeTimestampstring · date-time · nullableOptional

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

lastChangeSessionIDstring · nullableOptional

ID of the latest session that changed this object.

Responses

200

Success

application/json

Response of an Add Medium request.

mediumIDstring · nullableOptional

Medium object ID.

requestIDinteger · int64Optional

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

requestDateTimestring · date-timeOptional

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

resultCodeinteger · int32Optional

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

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

post

/memori/v2/Medium/{strSessionID}/{strMemoryID}

HTTPcURLJavaScriptPython

POST /memori/v2/Medium/{strSessionID}/{strMemoryID} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 282

{
  "mediumID": "text",
  "url": "text",
  "content": "text",
  "mimeType": "text",
  "title": "text",
  "properties": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "creationTimestamp": "2026-03-07T10:38:47.614Z",
  "creationSessionID": "text",
  "lastChangeTimestamp": "2026-03-07T10:38:47.614Z",
  "lastChangeSessionID": "text"
}

200

Success

{
  "mediumID": "text",
  "requestID": 1,
  "requestDateTime": "2026-03-07T10:38:47.614Z",
  "resultCode": 1,
  "resultMessage": "text"
}