Build Container / build (push) Successful in 6s
Update (replace/add/delete) for content, name, category, photo, in-reply-to, post-status; soft delete with undelete; post-status drafts; in-reply-to; multipart and remote photos; q=source lists and properties[]; q=category; media scope. Fix media endpoint 404 at the advertised /micropub/media path. ADR-067. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
ADR-067: Micropub update, delete, drafts and replies
Status
Accepted (v2.4.0, 2026-10-31)
Context
The Micropub endpoint could only create published notes. Apps could not edit or delete posts, drafts and replies were dropped, and photos sent with the post or hosted elsewhere were lost.
Decision
- Update (JSON only,
updatescope). Supported properties are the ones a note can store:content,name(the# Headingfirst line),category,photo,in-reply-to,post-status. Anything else is a 400, not silently ignored. Order: delete, then replace, then add (addonly forcategoryandphoto). Success is 204. - Delete is soft (
deletescope) soundeletecan restore the note and its file from.trash/. Crossposts are removed on delete and posted again on undelete. - Drafts:
post-status: draftcreates an unpublished note; crossposts wait until it is published. - Photos: multipart uploads are saved like media-endpoint uploads; remote URLs are downloaded only from public IP addresses, up to 20 MB, max 4.
- Queries:
q=sourcereturns everything create accepts (round-trip); withouturlit lists recent posts, drafts included, for editing apps.q=categorylists tags by use.
Consequences
published(backdating) can be set on create but not changed by update.- Likes, reposts and bookmarks remain unsupported (round 2).