/files/{id}/download/request-meta

Returns metadata to construct an authenticated file download request for a singular file, allowing you to download file directly from the third-party. For information on our download process please refer to our <a href='https://help.merge.dev/articles/10644317' target='_blank'>direct file download help center article</a>.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

idstringRequiredformat: "uuid"

Query parameters

mime_typestringOptional

If provided, specifies the export format of the file to be downloaded.

Response

idstring

urlstring

methodstring

headersmap from strings to any

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

descriptionstring or nullOptional<=2000 characters

The file's description.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

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.

permissionslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

file_thumbnail_urlstring or nullOptional<=2000 characters

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

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

descriptionstring or nullOptional<=2000 characters

The file's description.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

drivestring or nullOptionalformat: "uuid"

The drive that the file belongs to.

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

drivestring or nullOptionalformat: "uuid"

The drive that the file belongs to.

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

drivestring or nullOptionalformat: "uuid"

The drive that the file belongs to.

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

descriptionstring or nullOptional<=2000 characters

The file's description.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

file_thumbnail_urlstring or nullOptional<=2000 characters

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

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

descriptionstring or nullOptional<=2000 characters

The file's description.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

drivestring or nullOptionalformat: "uuid"

The drive that the file belongs to.

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

drivestring or nullOptionalformat: "uuid"

The drive that the file belongs to.

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

namestring or nullOptional<=254 characters

The file's name.

file_urlstring or nullOptional<=2000 characters

The URL to access the file.

sizelong or nullOptional-9223372036854776000-9223372036854776000

The file's size, in bytes.

mime_typestring or nullOptional<=128 characters

The file's mime type.

folderstring or nullOptionalformat: "uuid"

The folder that the file belongs to.

checksummap from strings to any or nullOptional

permissionslist of objectsOptional

drivestring or nullOptionalformat: "uuid"

The drive that the file belongs to.

remote_created_atdatetime or nullOptional

When the third party's file was created.

remote_updated_atdatetime or nullOptional

When the third party's file was updated.

remote_datalist of objects or nullOptionalRead-only

1	from merge import Merge
2
3	client = Merge(
4	account_token="YOUR_ACCOUNT_TOKEN",
5	api_key="YOUR_API_KEY",
6	)
7	client.file_storage.files.download_request_meta_retrieve(
8	id="id",
9	)

1	{
2	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3	"url": "https://www.googleapis.com/drive/v3/files/234?alt=media",
4	"method": "GET",
5	"headers": {
6	"Authorization": "Bearer 1234"
7	}
8	}

/files/{id}/download/request-meta

Authentication

Path parameters

Headers

Query parameters

Response

Field support by integration

Field support by integration