Skip to content

Submit a Community Photo

POST /api/v1/libraries/{slug}/photo

Submit a community photo for an approved library. The photo starts in pending status and must be approved by a moderator before it appears publicly. Each user can submit up to 3 photos per library.

Auth required: Yes (Bearer token)

Content type: multipart/form-data

Path parameters

Parameter Type Description
slug string URL slug of the library to add a photo to

Fields

Field Type Required Description
photo file Yes Photo of the library (JPEG/PNG/WEBP/HEIC/HEIF, max 10 MB). Accepted uploads are normalized to an optimized JPEG targeting about 500 KB.
caption string No Optional caption for the photo (max 200 chars)

Examples

curl -X POST https://bookcorners.org/api/v1/libraries/berlin-friedrichstr-12-corner-books/photo \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -F "photo=@community-photo.jpg" \
  -F "caption=Summer view from the park side"

import requests

resp = requests.post(
    "https://bookcorners.org/api/v1/libraries/berlin-friedrichstr-12-corner-books/photo",
    headers={"Authorization": f"Bearer {access_token}"},
    data={"caption": "Summer view from the park side"},
    files={"photo": open("community-photo.jpg", "rb")},
)
print(resp.json())

Submit without a caption

curl -X POST https://bookcorners.org/api/v1/libraries/berlin-friedrichstr-12-corner-books/photo \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -F "photo=@community-photo.jpg"

resp = requests.post(
    "https://bookcorners.org/api/v1/libraries/berlin-friedrichstr-12-corner-books/photo",
    headers={"Authorization": f"Bearer {access_token}"},
    files={"photo": open("community-photo.jpg", "rb")},
)

Response (201 Created)

{
  "id": 15,
  "caption": "Summer view from the park side",
  "status": "pending",
  "created_at": "2025-06-15T14:30:00Z"
}

Note

The photo will have pending status. It won't appear on the library detail page until approved by a moderator. Each user can submit up to 3 photos per library (rejected photos do not count towards this limit).

Errors

Status Cause
400 Invalid photo format, or per-user limit of 3 photos reached for this library
404 Library not found or not in approved status
413 Photo exceeds 10 MB size limit
422 Request validation error
429 Rate limit exceeded (see Rate Limiting)