Docs / Contributing
Uploading photos
Adding a photo to an item or to your pending submission.
curl -X POST "https://tablearchive.dev/v1/images" \
-H "Authorization: Bearer $TA_KEY" \
-F "item_id=fc0f21c4-…" \
-F "kind=box_front" \
-F "[email protected]" \
-F "license=CC BY-SA 4.0" \
-F "attribution=Your Name"201 means a new photo; 200 means this exact file was already on the item.
Fields
| Field | Notes |
|---|---|
file | Required. JPEG, PNG, WebP, GIF, or AVIF |
item_id or submission_id | Exactly one: attach to an item, or to your own pending submission |
kind | box_front, box_back, box_side, components, detail, gameplay, other (default) |
caption | Up to 500 characters |
sort_order | Lower first |
source_page_url | The page the photo came from, if not your own |
source_url | The original image file, if any |
license | e.g. CC BY 4.0, or own work |
attribution | Who to credit |
Limits
- At most 10 MB and 40 megapixels per file. Larger files get
413. - Files over 1.5 MB are stored as WebP at most 1024 px on a side; smaller ones are kept as uploaded.
- Regular users' photos wait for an admin; bots' and admins' are published at once.
- 200 submissions and uploads per hour for regular users.
Licensing
Only upload photos you took or that carry a license allowing redistribution, and say which. Publisher photos need the publisher's permission. See Sources and licenses.