Get Upload Tags
Retrieve all tags associated with an upload.Request
Response
Add Tags to Upload
Add tags to an existing upload.Request
Parameters
| Parameter | Type | Description |
|---|---|---|
tags | array | Array of tag names (max 10 total on upload) |
Response
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
400error), not stripped - Tag names are trimmed, but their case is preserved (only the generated
slugis lowercased) - Tags that are already on the upload are silently ignored — they don’t count toward
addedand won’t cause an error
Authorization
- Only the upload owner can add tags
- Admins can add tags to any upload
Errors
| Status | Description |
|---|---|
| 400 | Tags array is required (missing, empty, or not an array) |
| 400 | Too many tags or invalid tag names |
| 401 | Not authenticated |
| 403 | Not authorized (not the owner) |
| 404 | Upload not found |
| 500 | Server error |