Edit Upload

​

Behavior

• You must own the upload to edit it, or belong to the owning team with a role other than viewer.
• At least one of title, description, post-privacy, or priority must be provided.
• Send title or description as multipart form fields. This is required for non-ASCII values such as emoji or accented characters, which cannot be carried in HTTP headers. The title and description headers still work for plain ASCII values but are discouraged.
• Send an empty string for title or description to clear the field.
• title is truncated to 30 characters, description to 200 characters.
• A newly added @username in the description sends that user a mention notification. Mentions already present before the edit are not re-notified.
• A restricted post cannot be made public. Setting post-privacy to public on a restricted post returns 403. You can still switch it between private and unlisted.
• priority is true or false and moves the post’s videos on or off priority (adaptive) streaming. Turning it on with no priority minutes left returns 403. Any other value returns 400.
• The response always carries priority, reflecting where the post’s videos ended up.

​

Examples

curl -X PATCH "https://relay.snipp.gg/editUpload" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "code: AbCd1234" \
  -H "post-privacy: public" \
  -F "title=New title 🎉"

curl -X PATCH "https://relay.snipp.gg/editUpload" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -H "code: AbCd1234" \
  -F "description="

​

Responses

{
  "message": "Upload updated successfully.",
  "post": {
    "code": "AbCd1234",
    "title": "New title",
    "description": null,
    "postPrivacy": "public",
    "priority": false
  }
}