Skip to main content

​
Overview

Uploads are the core content type in FoN. Users can upload images or submit links for the community to vote on.

​
Upload Types

FoN supports three types of uploads:

​
Image Upload

Upload an image file directly to FoN. Supported formats: JPEG, PNG, GIF, WebP Size limit: 10 MB 
curl -X POST https://fucksornot.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "upload_type=image" \
  -F "description=Check out this gadget" \
  -F "file=@/path/to/image.jpg"

​
Image URL

Submit a URL to an image hosted elsewhere. FoN will fetch and process the image.
Image URL uploads are only available via the cookie-authenticated /api/upload endpoint (not /api/v1/upload, which only accepts image or link).
curl -X POST https://fucksornot.com/api/upload \
  -H "Cookie: auth-token=YOUR_JWT_TOKEN" \
  -F "upload_type=image_url" \
  -F "description=Cool find from the web" \
  -F "image_url=https://example.com/image.jpg"
Submit a link to external content. FoN supports rich embeds for popular platforms. Supported platforms:
  • Bluesky
  • Instagram
  • Threads
  • YouTube
  • Tumblr
  • Spotify
curl -X POST https://fucksornot.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "upload_type=link" \
  -F "description=Great video" \
  -F "external_url=https://youtube.com/watch?v=..."

​
Upload Properties

PropertyTypeDescription
idUUIDUnique identifier
user_idUUIDOwner’s user ID
filenamestringStored filename (images only)
original_namestringOriginal filename
descriptionstringUser-provided description (max 500 chars)
upload_typestringimage or link
external_urlstringURL for links
upvotesintegerNumber of “fucks” votes
downvote_countintegerNumber of “does not fuck” votes
is_privatebooleanPrivacy status
tagsarrayAssociated tags
created_attimestampCreation time

​
Duplicate Detection

FoN automatically detects duplicate image uploads using content hashing. If you upload an image that already exists, you’ll receive: 
{
  "duplicate": true,
  "existingUploadId": "uuid-of-existing-upload",
  "message": "This image has already been uploaded"
}

​
Image Processing

Uploaded images are automatically:
  1. Validated - Checked for supported format and size
  2. Analyzed - Scanned for content (human detection)
  3. Optimized - Converted to efficient formats
  4. Thumbnailed - Generated preview versions

​
Privacy

Uploads can be made private. The privacy endpoint toggles the current setting — there’s no request body, and calling it again switches it back: 
curl -X PATCH https://fucksornot.com/api/upload/UPLOAD_ID/privacy \
  -H "Cookie: auth-token=YOUR_JWT_TOKEN"
This returns the updated upload along with its new privacy state: 
{
  "success": true,
  "upload": { /* ...updated upload object... */ },
  "is_private": 1
}
Private uploads:
  • Don’t appear in public feeds
  • Only visible to the owner and admins
  • Still accessible via direct link (if you know the ID)

​
Tags

Add tags to help categorize your upload: 
curl -X POST https://fucksornot.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "upload_type=image" \
  -F "description=My upload" \
  -F "tags=gadget,tech,cool" \
  -F "file=@image.jpg"
Tag limits:
  • Maximum 10 tags per upload
  • Tags are comma-separated

​
Rate Limits

Uploads are rate limited to 20 per hour per user to prevent abuse.

​
Deleting Uploads

Users can delete their own uploads: 
curl -X DELETE https://fucksornot.com/api/upload/UPLOAD_ID \
  -H "Cookie: auth-token=YOUR_JWT_TOKEN"
Deletion is permanent and cannot be undone.