Upload Tags

​

Get Upload Tags

​

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

​

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"]}'

const response = await fetch(
  'https://fucksornot.com/api/uploads/550e8400-e29b-41d4-a716-446655440000/tags',
  {
    method: 'POST',
    credentials: 'include',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      tags: ['new-tag', 'another-tag']
    })
  }
);

​

Parameters

​

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
}

​

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