head

HTTP Request

HEAD /api/v1/rawFiles/:fileId

Path parameters

ParameterTypeDescription

:fileId

string

The globally unique identifier for this file

Query parameters

None

Authorization

You must have metadata access to file's associated dataset, and your access token must have the following scope:

  • data.metadata

Learn more about authorization.

Request body

The request body must be empty.

Response headers

In addition to standard response headers, this API provides the additional information associated with the file:

NameDescription

Content-Disposition

HTTP content disposition, including information about the file's name. However, it is recommended to use X-Redivis-Filename as the content-disposition can be hard to parse.

Content-Length

The size, in bytes, of the response. Note if using Range Requests, this will be the size of the current response, not the entire file.

Content-Range

Will only be returned if a Range was set on the request headers. Takes the form

bytes startByte-endByte/total

Content-Type

The file's MIME type, derived from the file extension. If the MIME type is unknown, will be set to application/octet-stream.

Digest

Contains the md5 checksum of the file content, encoded as a base64 string. Takes the form md5=checksum

X-Redivis-Filename

The URL-encoded representation of the filename.

Response body

No content is returned in the response body.

Examples

curl -I -H "Authorization: Bearer $REDIVIS_ACCESS_TOKEN" \
"https://redivis.com/api/v1/rawFiles/93qh-6wdzwrz84.bc574P4o8ypzp8yKCnrgIw"

Last updated