Skip to main content

Get Upload Tags

Retrieve all tags associated with an upload.

Request

curl https://fucksornot.com/api/uploads/550e8400-e29b-41d4-a716-446655440000/tags

Response

{
  "tags": [
    {
      "id": "tag-uuid-1",
      "name": "gadget",
      "slug": "gadget"
    },
    {
      "id": "tag-uuid-2",
      "name": "tech",
      "slug": "tech"
    }
  ]
}

Add Tags to Upload

Add tags to an existing upload.

Request

curl -X POST https://fucksornot.com/api/uploads/550e8400-e29b-41d4-a716-446655440000/tags \
  -H "Cookie: auth-token=YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["new-tag", "another-tag"]}'

Parameters

ParameterTypeDescription
tagsarrayArray of tag names (max 10 total on upload)

Response

{
  "success": true,
  "tags": [
    {
      "id": "tag-uuid-1",
      "name": "gadget",
      "slug": "gadget"
    },
    {
      "id": "tag-uuid-2",
      "name": "new-tag",
      "slug": "new-tag"
    },
    {
      "id": "tag-uuid-3",
      "name": "another-tag",
      "slug": "another-tag"
    }
  ],
  "added": 2
}
tags is the full, updated list of tags on the upload after the request. added is the number of tags that were newly added (tags already present on the upload are silently skipped and not counted).

Tag Limits

  • Maximum 10 tags per upload
  • If adding tags would exceed the limit, the request is rejected
  • Tag names must be between 2 and 50 characters
  • Tag names can only contain letters, numbers, spaces, and hyphens — names with other characters are rejected (with a 400 error), not stripped
  • Tag names are trimmed, but their case is preserved (only the generated slug is lowercased)
  • Tags that are already on the upload are silently ignored — they don’t count toward added and won’t cause an error

Authorization

  • Only the upload owner can add tags
  • Admins can add tags to any upload

Errors

StatusDescription
400Tags array is required (missing, empty, or not an array)
400Too many tags or invalid tag names
401Not authenticated
403Not authorized (not the owner)
404Upload not found
500Server error