Files
StarPunk/docs/decisions/ADR-067-micropub-update-delete.md
PhilandClaude Opus 5.5 0d3a5cd519
Build Container / build (push) Successful in 6s
feat: Micropub update, delete/undelete, drafts, replies (v2.4.0)
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>
2026-10-31 19:53:18 -06:00

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

  1. Update (JSON only, update scope). Supported properties are the ones a note can store: content, name (the # Heading first line), category, photo, in-reply-to, post-status. Anything else is a 400, not silently ignored. Order: delete, then replace, then add (add only for category and photo). Success is 204.
  2. Delete is soft (delete scope) so undelete can restore the note and its file from .trash/. Crossposts are removed on delete and posted again on undelete.
  3. Drafts: post-status: draft creates an unpublished note; crossposts wait until it is published.
  4. Photos: multipart uploads are saved like media-endpoint uploads; remote URLs are downloaded only from public IP addresses, up to 20 MB, max 4.
  5. Queries: q=source returns everything create accepts (round-trip); without url it lists recent posts, drafts included, for editing apps. q=category lists tags by use.

Consequences

  • published (backdating) can be set on create but not changed by update.
  • Likes, reposts and bookmarks remain unsupported (round 2).