Add to Album

Add one or more files to an existing album post. Use this to grow a post’s file list in place. The post’s share code, privacy, title, and description stay the same.

Headers

Header	Required	Description
`relay-key`	Yes	Your Relay key
`post-code`	Yes	The share code of the post to append to
`include-metadata`	No	`true` to keep file metadata. Omitted or `false` strips it (default).
`priority`	No	`false` to opt appended video files out of priority (adaptive) streaming. Omitted or `true` keeps it on (default), subject to your remaining priority minutes.

Behavior

You must own the post.
The post cannot be moderated. Moderated posts reject modifications.
Albums cap at 9 files total. Requests that would exceed the cap are rejected.
Newly added files inherit the post’s existing privacy. If the post is private, returned urls are signed with a 24-hour expiry.
Video files (.mp4, .mov, .mkv) are remuxed to MP4 with +faststart. See File Types for details.
Metadata (EXIF on images, container metadata on videos) is stripped by default. Send include-metadata: true to keep it.
Appended videos use priority (adaptive) streaming by default, spending priority minutes. Send priority: false to add them in standard quality instead. The post’s priority field is true when any file in the album is on adaptive streaming.
Each new file is auto-moderated. If any file (or the post’s title or description) is flagged, the entire post, including existing files, is quarantined and marked moderated.

Examples

Add two images to an existing album:

curl -X POST "https://relay.snipp.gg/appendUpload" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "post-code: AbCd1234" \
  -F "file=@photo4.png" \
  -F "file=@photo5.png"

Convert a single-file post into an album by appending a second file:

curl -X POST "https://relay.snipp.gg/appendUpload" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "post-code: AbCd1234" \
  -F "file=@second.png"

Responses

{
  "message": "Files added to album successfully.",
  "post": {
    "code": "AbCd1234",
    "url": "https://snipp.gg/p/AbCd1234",
    "postPrivacy": "public",
    "fileCount": 5,
    "priority": false
  },
  "files": [
    {
      "index": 3,
      "fileName": "a1b2c3d4e5f6789012345678abcdef01.png",
      "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
      "size": 2487312,
      "size_formatted": "2.37 MB",
      "mime_type": "image/png",
      "status": "success",
      "dimensions": { "width": 1920, "height": 1080 }
    }
  ]
}

If some files fail, a failed array is included alongside files:

{
  "failed": [
    {
      "index": 4,
      "error": "Album cap of 9 files exceeded",
      "status": "failed"
    }
  ]
}

Overview

Uploads

Posts

Users

Notifications

Meta

Add to Album

Headers

Behavior

Examples

Responses

​Headers

​Behavior

​Examples

​Responses

Headers

Behavior

Examples

Responses