Micropub inline photo file in create request #133

Open
opened 2026-08-06 15:40:22 +00:00 by rosa · 0 comments
Owner

Micropub: accept an inline photo file in the create request

Deferred from #131. v1 Micropub attaches a Photo by referencing a
media-endpoint URL only
; POST /micropub stays JSON / urlencoded, and the
media-endpoint is advertised in q=config so compliant clients upload there
first.

Micropub also permits inlining the photo as a file part in a
multipart/form-data create to /micropub (many phone clients do this and never
touch a media endpoint). Supporting it means /micropub grows a multipart path.

Why deferred: the media endpoint already covers well-behaved clients, and the
web editor covers "just pick a file". Per ADR-0019 this is a thin third adapter
over the same create Media op
, not new storage logic, so it's cheap to add later.

Signal to revisit: a Micropub client people actually use can only inline
photos and can't attach one via the media endpoint.

## Micropub: accept an inline photo file in the create request Deferred from #131. v1 Micropub attaches a Photo by **referencing a media-endpoint URL only**; `POST /micropub` stays JSON / urlencoded, and the `media-endpoint` is advertised in `q=config` so compliant clients upload there first. Micropub also permits inlining the photo as a file part in a `multipart/form-data` create to `/micropub` (many phone clients do this and never touch a media endpoint). Supporting it means `/micropub` grows a multipart path. **Why deferred:** the media endpoint already covers well-behaved clients, and the web editor covers "just pick a file". Per ADR-0019 this is a **thin third adapter over the same `create Media` op**, not new storage logic, so it's cheap to add later. **Signal to revisit:** a Micropub client people actually use can only inline photos and can't attach one via the media endpoint.
rosa changed title from Deferred: Micropub inline photo file in create request to Micropub inline photo file in create request 2026-08-10 02:17:19 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
rosa/vernier#133
No description provided.