Uploads

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"

Link

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

Property	Type	Description
`id`	UUID	Unique identifier
`user_id`	UUID	Owner’s user ID
`filename`	string	Stored filename (images only)
`original_name`	string	Original filename
`description`	string	User-provided description (max 500 chars)
`upload_type`	string	`image` or `link`
`external_url`	string	URL for links
`upvotes`	integer	Number of “fucks” votes
`downvote_count`	integer	Number of “does not fuck” votes
`is_private`	boolean	Privacy status
`tags`	array	Associated tags
`created_at`	timestamp	Creation 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:

Validated - Checked for supported format and size
Analyzed - Scanned for content (human detection)
Optimized - Converted to efficient formats
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)

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.

Getting Started

Core Concepts

Overview

Upload Types

Image Upload

Image URL

Link

Upload Properties

Duplicate Detection

Image Processing

Privacy

Tags

Rate Limits

Deleting Uploads

​Overview

​Upload Types

​Image Upload

​Image URL

​Link

​Upload Properties

​Duplicate Detection

​Image Processing

​Privacy

​Tags

​Rate Limits

​Deleting Uploads

Overview

Upload Types

Image Upload

Image URL

Link

Upload Properties

Duplicate Detection

Image Processing

Privacy

Tags

Rate Limits

Deleting Uploads