Add to Album

​

Headers

​

Behavior

• You must own the post.
• The post cannot be moderated. Moderated posts reject modifications.
• Albums cap at 50 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 is stripped by default: PNG, JPG, WebP and GIF are stripped structurally at any size, so the pixels are untouched, and videos lose their container metadata during the MP4 remux. 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.
• Failures: when every file in the request fails, the response is 400. For a single-file upload the reason is returned directly as error (for example Weekly usage limit exceeded.). For multi-file uploads the response is All files failed to upload. with a failed array naming each file by index.

​

Examples

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

curl -X POST "https://api.snipp.gg/appendUpload" \
  -H "api-key: YOUR_API_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": 0,
      "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 }
    }
  ]
}

{
  "failed": [
    {
      "index": 4,
      "error": "Failed to process file.",
      "status": "failed"
    }
  ]
}