Since the moment when this idea was published REST API operations for /files/ where improved. Right now we may return files using multiple different operations:
- GET /v3/files - which returns list of files from chosen folder with pagination options
- GET /v3/files/{externalKey} - which returns a file based on external key of the file
- GET /v3/files/{externalKey}/fileInfo - which returns metadata of the file based on external key of the file
- GET /v3/files/path - which returns a file based on file path from table or view field
- GET /v3/files/path/fileInfo - which returns file metadata based on file path from table or view field

Please write if this request can be closed or describe what you expect.

In addition to File data type we introduced Attachment data type which is storing files directly in a table field. Attachment data type has its own set of REST API operations under /tables/ operations.

All updates you may preview in: https://demo.caspio.com/integrations/rest/swagger
OR test it on your Caspio account using swagger UI on your account:
https://<Your integration URL>/integrations/rest/swagger