Skip to main content
POST

Overview

Updates metadata on an existing file without re-uploading its content. This is the endpoint to use when you need to:
  • Preserve the original modification time of a file after upload (equivalent to rclone’s SetModTime)
  • Attach or merge EXIF data after the file content has been uploaded
  • Link an iOS Live Photo to its video counterpart
At least one of lastModified or exifData must be provided, otherwise the request fails with a 422 error.

Path Parameters

integer
required
The numeric file entry ID. Entry hashes are not accepted on this endpoint.

Request Body

integer
Original client-side modification time as a Unix epoch in milliseconds (e.g. 1712345678000). Stored in the entry’s client_last_modified field and merged into its EXIF data.
Milliseconds, not seconds. 1712345678 (seconds) would be interpreted as January 1970.
string | object
EXIF metadata to merge into the entry. Accepts either:
  • A base64-encoded JSON string
  • A raw JSON string
  • A plain JSON object
Existing EXIF keys are preserved; provided keys overwrite matching ones. If the merged EXIF contains a capture date, the entry’s captured_at (used by the photo timeline) is updated too.
string
Apple Live Photo content identifier. Only stored if the entry does not already have one.

Response

string
Request status (success)
boolean
true when the metadata was stored
You can also set lastModified directly at upload time by including it in the Upload File or Create S3 Entry request body. Use this endpoint when the file already exists, or to fix timestamps after the fact.