Save and read

Upload a photo, video or file

As a new save, or attached to an existing one (itemId). With itemId and cover: true, a photo or video becomes the picture on that save's tile (nothing is deleted; a file that was in front stays behind it). fileUrl: a public https link, up to 25 MB. data: base64, up to 3 MB. Counts against the person's storage.

post/api/v1/files

Request

  • Base URL: https://savehq.app
  • URL: https://savehq.app/api/v1/files
  • Auth: HTTP bearer

Request body

fileUrlstring
datastring

base64

filenamestring
mimeTypestring
itemIdstring
coverboolean

With itemId: make this photo or video the save's tile picture.

captionstring
categoryIdstring
privateboolean

Response

Stored: save_id, file_id, kind, size_bytes, new_save, title, title_is_automatic, remaining_bytes, and cover.previous_file_id when cover was set. With no caption the title is "Photo: IMG_4823" (kind and file name), renamed to what the file shows once SaveHQ has read it.

Changes

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