Photos

User Guide

For a user-facing walkthrough, see Photos.

Photo retrieval and deletion. Photo upload is on the Bins route (POST /api/bins/{id}/photos).

---

GET /api/photos

Lists all photos for a bin.

Query parameters

Parameter	Type	Required	Description
bin_id	UUID	Yes

Response (200)

{
  "results": [
    {
      "id": "uuid",
      "bin_id": "uuid",
      "filename": "photo.jpg",
      "mime_type": "image/jpeg",
      "size": 204800,
      "created_by": "uuid",
      "created_at": "..."
    }
  ],
  "count": 2
}

---

GET /api/photos/{id}/file

Serves the full-size photo binary. Auth is required via cookie or Bearer header. Returns an immutable 1-year cache header.

Path parameters: id (photo UUID)

Response (200): Binary image (image/*).

---

GET /api/photos/{id}/thumb

Serves a 600px-wide WebP thumbnail of the photo. The thumbnail is generated lazily on first request and cached for subsequent loads. Returns an immutable 1-year cache header.

Path parameters: id (photo UUID)

Response (200): Binary image (image/webp).

If the original photo is missing from storage, returns 404.

---

DELETE /api/photos/{id}

Deletes a photo record and removes the file from storage.

Path parameters: id (photo UUID)

Response (200): { "message": "Photo deleted" }