Photos

Upload a photo

Raw image bytes in the body (JPEG, PNG, WebP, HEIC or HEIF; sniffed, not trusted from the header), metadata in the query. Upload the original, then a small JPEG rendition with kind=thumb under the same photo_id — in either order. A source_id already on the trip returns the existing photo (200) instead of a duplicate. Free accounts hold 100 photos.

post/api/trips/{id}/photos

Request

  • Base URL: https://trvlrr.app
  • URL: https://trvlrr.app/api/trips/{id}/photos
  • Auth: HTTP bearer

Path parameters

idstring required

The trip id.

Query parameters

photo_idstring

Client-chosen id so the original and the thumbnail can arrive in any order.

kind'original' | 'thumb'

thumb for the small JPEG rendition; original otherwise.

source_idstring

SHA-256 of the source image, for de-duplication.

taken_atstring

ISO 8601 instant the photo was taken.

latnumber nullable
lonnumber nullable

Response

Already present (same source_id): the existing photo.

idstring required
trip_idstring required
experience_idstring nullable required
r2_keystring required
content_typestring nullable required
size_bytesinteger nullable required
widthinteger nullable required
heightinteger nullable required
taken_atstring nullable required
latnumber nullable required
lonnumber nullable required
uploaded_bystring nullable required
created_atstring required
thumb_r2_keystring nullable required
captionstring nullable required
tagsstring nullable required
landmarkstring nullable required
ocr_textstring nullable required
indexed_atstring nullable required
user_tagsstring nullable required

JSON array, as text.

faces_atstring nullable required
source_idstring nullable required

The client's hash of the source image, for de-duplication.

Changes

No recorded changes to this operation across all 1 revision of this API.