Skip to main content
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

HeaderRequiredDescription
relay-keyYesYour Relay key
post-codeYesThe share code of the post to append to
include-metadataNotrue to keep file metadata. Omitted or false strips it (default).

​
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.
  • 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
  },
  "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"
    }
  ]
}