LiquidFiles Documentation
LiquidFiles Documentation

Attachments Information

An Attachment in LiquidFiles is the object that contains a file and that can be attached to one or more Secure Messages or FileLinks.

Accessing attachments is done through the Secure Message API, Filedrop API or the FileLink API respectively.

Creating (Uploading) the Attachment is also covered in the respective API section:

Attachment Parameters

When listing, viewing or creating an attachment via either of the mentioned API methods above, the API will respond with one or many attachments and will be similar regardless of main API used — the Secure Message Attachment API response will be very similar to the FileLink Attachment API. Each attachment object will have response parameters as outlined in the Attachment Attraibutes API.

Listing Attachments

You can use this API to list a users available attachments, expired or deleted attachments will not be visible.

Request Info
Info Value
Request URL /attachments
Request VERB GET

Example using curl

curl --user "ojubiigauS2TxTy4ovk6Ph:x" -H "Accept: application/json" \
  https://liquidfiles.company.com/attachments

{"attachments":
  [
    {
      "id":"8mop0J8KXRa93DasEdTdiJ",
      "filename":"quod.odp",
      "size":3132812,
      "content_type":"video/quicktime",
      "checksum":"5a9a8cb868a53679b9e28d06523cdd6580044560a98401da9b81c8314056dccc",
      "crc32":"44b411",
      "assembled":true,
      "virus_scan_required":true,
      "virus_scanned":true,
      "virus_scanned_at":"2019-12-10T00:41:23.300Z",
      "actionscript":null,
      "actionscript_scanned_at":null,
      "actionscript_scanned":false,
      "content_blocked":false,
      "content_blocked_message":null,
      "processed":true,
      "processed_at":"2019-12-10T00:41:23.300Z",
      "expires_at":"2020-01-09",
      "created_at":"2019-12-10T00:41:22.000Z",
      "available":true,
      "size_human":"2.99 MB",
      "messages":["ctunaJMapLydXlG694MsAA"],
      "filelinks":[]
    },
    {
      "id":"lCJtYIlEeHjTsQiQrz2QFv",
      "filename":"soluta.pages",
      "size":4658246,
      "content_type":"audio/vnd.wave",
      "checksum":"7a26202ea49d5296bb932c9c16bb707e26d6c1362996d9acd9e2dca59e464e1b",
      "crc32":"5424bd",
      "assembled":true,
      "virus_scan_required":true,
      "virus_scanned":true,
      "virus_scanned_at":"2019-12-10T00:41:23.300Z",
      "actionscript":null,
      "actionscript_scanned_at":null,
      "actionscript_scanned":false,
      "content_blocked":false,
      "content_blocked_message":null,
      "processed":true,
      "processed_at":"2019-12-10T00:41:23.300Z",
      "expires_at":"2020-01-09",
      "created_at":"2019-12-10T00:41:22.000Z",
      "available":true,
      "size_human":"4.44 MB",
      "messages":["ctunaJMapLydXlG694MsAA"],
      "filelinks":[]
    }
  ]
}

Show Attachment

You can view an individual attachments with this API call.

Request Info
Info Value
Request URL /attachments/_attachment_id_
Request VERB GET

Example using curl

curl --user "ojubiigauS2TxTy4ovk6Ph:x" -H "Accept: application/json" \
  https://liquidfiles.company.com/attachments/8mop0J8KXRa93DasEdTdiJ

{"attachment":
  {
    "id":"8mop0J8KXRa93DasEdTdiJ",
    "filename":"quod.odp",
    "size":3132812,
    "content_type":"video/quicktime",
    "checksum":"5a9a8cb868a53679b9e28d06523cdd6580044560a98401da9b81c8314056dccc",
    "crc32":"44b411",
    "assembled":true,
    "virus_scan_required":true,
    "virus_scanned":true,
    "virus_scanned_at":"2019-12-10T00:41:23.300Z",
    "actionscript":null,
    "actionscript_scanned_at":null,
    "actionscript_scanned":false,
    "content_blocked":false,
    "content_blocked_message":null,
    "processed":true,
    "processed_at":"2019-12-10T00:41:23.300Z",
    "expires_at":"2020-01-09",
    "created_at":"2019-12-10T00:41:22.000Z",
    "available":true,
    "size_human":"2.99 MB",
    "messages":["ctunaJMapLydXlG694MsAA"],
    "filelinks":[]
  }
}

Delete Attachment

You can delete an individual attachments with this API call.

Request Info
Info Value
Request URL /attachments/_attachment_id_
Request VERB DELETE

Example using curl

curl -X DELETE --user "ojubiigauS2TxTy4ovk6Ph:x" -H "Accept: application/json" \
  https://liquidfiles.company.com/attachments/8mop0J8KXRa93DasEdTdiJ

{"attachment":
  {
    "id":"8mop0J8KXRa93DasEdTdiJ",
    "filename":"quod.odp",
    "size":3132812,
    "content_type":"video/quicktime",
    "checksum":"5a9a8cb868a53679b9e28d06523cdd6580044560a98401da9b81c8314056dccc",
    "crc32":"44b411",
    "assembled":true,
    "virus_scan_required":true,
    "virus_scanned":true,
    "virus_scanned_at":"2019-12-10T00:41:23.300Z",
    "actionscript":null,
    "actionscript_scanned_at":null,
    "actionscript_scanned":false,
    "content_blocked":false,
    "content_blocked_message":null,
    "processed":true,
    "processed_at":"2019-12-10T00:41:23.300Z",
    "expires_at":"2020-01-09",
    "created_at":"2019-12-10T00:41:22.000Z",
    "available":false,
    "size_human":"2.99 MB",
    "messages":["ctunaJMapLydXlG694MsAA"],
    "filelinks":[]
  }
}