files

Retrieve

Returns a File object with the given id.<Footer>{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS /}<MergeSupportedFieldsByIntegrationWidget requestType="GET" data="H4sIAAAAAAAAA92T227aQBCGX6XaS2RwCaFRkKoKQg6gYtKERE2jyBrWg72wp+yuOTjKu1c2JECbi1yQRO2dd3bmX8988z8QCg5jZRakQUaMo3XKQIzEI0JFyEmDnDCeH0GzAARup4XTPeIRm2qtjMPohCGP7JnBEWkQX6CJsZxKNmIY+RtVPpMOYwOOKWn95+ryqCgnHuFMTjBqUqpS6V6ht8wvw7Lgj6P1ObOOeESDtS4xKo2TC7xP0b5GOv87jgKlA16OwIG/IVM2S52XYnkfEXJ0GLXBQRsd0rzh1ZOJc9o2fD9BrivF85UIpz5KH4xjlKP167XDvYPDenmlUrz+LYz512ppfD9Uw4NSGFMeQlrqDeg8GHRmwTjeD47250F2VQ+ySRaMJ59LYQyl3qBX7w9uav12s9p/ISG8/PLz8LrVbnWDEs2Oa8H4ZhYMaLU3oJNh1ql1T+mse/ZjHmQ3e732VS0YHNe7p6raP7qwvaML1WtWKsQjm1xJ4/ZhM7Banpaabyd2RL5u64EsUYBmZZ0OOaMVW6uAgExJmNkKVcIXGDHwzzm4kTKipeahvU/BYDgOzOzXgaxoGT8Nnyn5PHnSIEFz0Lk+3t6F5hQYhyFH0nAmxb/WmTRuCU2QTmwqCllLDdOFoFd4IUwNX32utkajEczaYgweGSkeockdxQSGbqFzO8l8HB7ZztSGCTCLsFDdvjIolMOQGgSHUQhuHcv3YvsUanDJOsSi9Xeqo7WAZRmSu/zuPmUGo3MwINChyZu+e/ReAtg2Sg93DXEl+gRSfJfXiVy8LchNdDsk9L40TpWKOX5qGzbF3SBZKoaFYnhZ8HhPQ0WrTooBuyQVQwmMb1jsDZB9vKn6EneI8MlVfYnFOFe2emOMm+D+R0aXCRg8V0y63VIqdHWu++GcOAyR238Q2N3jbzWxysjJCgAA" />{/ END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}</Footer>

get/filestorage/v1/files/{id}

Request

  • Base URL: https://api.merge.dev/api
  • URL: https://api.merge.dev/api/filestorage/v1/files/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Query parameters

expandFilesIdGetParametersExpandSchemaItems[]

Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

include_remote_databoolean

Whether to include the original data Merge fetched from the third-party to produce these models.

include_shell_databoolean

Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).

Headers

X-Account-Tokenstring required

Token identifying the end user.

Response

idstring uuid
remote_idstring nullable

The third-party API ID of the matching object.

created_atstring date-time

The datetime that this object was created by Merge.

modified_atstring date-time

The datetime that this object was modified by Merge.

namestring nullable

The file's name.

file_urlstring nullable

The URL to access the file.

file_thumbnail_urlstring nullable

The URL that produces a thumbnail preview of the file. Typically an image.

sizeinteger nullable

The file's size, in bytes.

mime_typestring nullable

The file's mime type.

descriptionstring nullable

The file's description.

folderstring uuid nullable

The folder that the file belongs to.

checksumobject nullable

This field stores file checksum data. 'type' indicates the algorithm (e.g. crc_32, sha1, sha256, quickXor, or md5), and 'content_hash' is the unique hash used to verify file integrity and detect alterations.

drivestring uuid nullable

The drive that the file belongs to.

remote_created_atstring date-time nullable

When the third party's file was created.

remote_updated_atstring date-time nullable

When the third party's file was updated.

remote_was_deletedboolean

Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.

Changes

No recorded changes to this operation across all 1 revision of this API.