Working examples

Example Apps

Trace real app flows back to the API docs. Each example links to its source repository and the Micro.blog endpoints it uses.

Official iOS and Android client

Micro.blog App

The Micro.blog mobile app is a React Native client that signs in with Micro.blog tokens, reads timelines, posts through Micropub, uploads media, manages bookmarks, and registers for push notifications.

microdotblog/microblog-react

React Native Axios Micropub IndieAuth XML-RPC

src/api/MicroBlogApi.js

Native Micro.blog REST endpoints for sign-in, timelines, replies, muting, push, bookmarks, and progress checks.

src/api/MicroPubApi.js

Micropub, IndieAuth, media upload, editing, drafts, pages, uploads, and collections.

src/api/XMLRPCApi.js

XML-RPC discovery and posting support for configured external blogs.

Micro.blog App

Official iOS and Android client

8 flows 34 endpoints

Sign in and token verification

The app can verify an existing app token or request an email sign-in link that returns to the custom mobile URL scheme.

2 endpoints

POST /account/signin

Sends the email sign-in link and mobile redirect metadata.

POST /account/verify

Verifies an app token and returns the signed-in account profile.

Source

login_with_token src/api/MicroBlogApi.js:25 login_with_email src/api/MicroBlogApi.js:47

Example

await axios.post("/account/signin", "", {
  params: {
    email,
    redirect_url: "microblog://signin/",
    app_name: "Micro.blog for Android"
  }
})

Profile, timelines, and discovery

Timeline screens use the posts APIs for profile lookups, discovery, conversations, and the signed-in user's replies.

4 endpoints

GET /posts/{username}

Loads a user's profile feed; the app passes count=0 when it only needs profile metadata.

GET /posts/discover

Loads the Discover feed and tagmoji metadata.

GET /posts/conversation

Loads conversation context for a timeline item.

GET /posts/replies

Loads the signed-in user's replies timeline.

Source

get_profile src/api/MicroBlogApi.js:77 get_discover_timeline src/api/MicroBlogApi.js:129 get_conversation src/api/MicroBlogApi.js:145 get_replies src/api/MicroBlogApi.js:346

Example

const profile = await axios.get(`/posts/${username}`, {
  headers: { Authorization: `Bearer ${token}` },
  params: { count: 0 }
})

Conversations and replies

Conversation screens fetch the reply thread, then post a reply with form data to avoid duplicate submissions.

2 endpoints

GET /posts/conversation

Fetches replies and context for a post ID.

POST /posts/reply

Publishes a reply to an existing Micro.blog post.

Source

get_conversation src/api/MicroBlogApi.js:145 send_reply src/api/MicroBlogApi.js:162

Example

const body = new FormData()
body.append("id", postId)
body.append("content", markdown)

await axios.post("/posts/reply", body, {
  headers: { Authorization: `Bearer ${token}` }
})

Posting, editing, drafts, and media

The composer uses Micropub for configuration, categories, syndication targets, source queries, post creation, updates, deletion, and media uploads.

9 endpoints

GET /micropub

Reads Micropub config, categories, syndication targets, contacts, posts, pages, drafts, and collections with q parameters.

POST /micropub

Creates posts, updates posts, publishes drafts, deletes posts, and manages collections.

GET /micropub/media

Searches and lists uploaded media.

POST /micropub/media

Uploads images, videos, audio, and other media.

POST /micropub/media/append

Uploads a large media file in chunks.

POST /micropub/media/finished

Marks a chunked upload as ready for server processing.

GET /micropub/media/waiting

Polls for media processing status.

DELETE /posts/{id}

Deletes an existing Micro.blog post by ID.

GET /posts/check

Checks whether publishing has completed and whether new posts are available.

Source

get_config src/api/MicroPubApi.js:152 send_post src/api/MicroPubApi.js:169 upload_image src/api/MicroPubApi.js:292 upload_chunk src/api/MicroPubApi.js:396 post_update src/api/MicroPubApi.js:558 check_publishing_progress src/api/MicroBlogApi.js:554

Example

const body = new FormData()
body.append("h", "entry")
body.append("content", markdown)
body.append("mp-destination", destination)
body.append("mp-syndicate-to[]", syndicationTarget)

await axios.post("https://micro.blog/micropub", body, {
  headers: { Authorization: `Bearer ${token}` }
})

Relationships, muting, and reporting

Profile and safety controls use relationship endpoints for follow state, reports, muted users, muted keywords, and hiding other replies.

6 endpoints

POST /users/follow

Follows a user from profile and discovery screens.

POST /users/unfollow

Unfollows a user.

POST /users/report

Reports a user from the profile actions menu.

GET /users/muting

Lists muted users and keywords for settings.

POST /users/mute

Mutes a user, keyword, or hides other replies.

DELETE /users/muting/{id}

Removes a muted user or keyword.

Source

follow_user src/api/MicroBlogApi.js:95 unfollow_user src/api/MicroBlogApi.js:112 report_user src/api/MicroBlogApi.js:187 get_muted_users src/api/MicroBlogApi.js:204 mute_user src/api/MicroBlogApi.js:220

Example

await axios.post("/users/mute", "", {
  headers: { Authorization: `Bearer ${token}` },
  params: {
    username,
    is_hiding_other_replies: true
  }
})

Push notifications

Device registration keeps push settings in sync with the signed-in Micro.blog account and the current platform environment.

3 endpoints

GET /users/push/info

Reads notification registration state for a device.

POST /users/push/register

Registers a device token for push notifications.

POST /users/push/unregister

Removes a device token when notifications are disabled or the user signs out.

Source

register_push src/api/MicroBlogApi.js:275 unregister_push src/api/MicroBlogApi.js:300 get_push_info src/api/MicroBlogApi.js:325

Example

await axios.post("/users/push/register", "", {
  headers: { Authorization: `Bearer ${token}` },
  params: {
    device_token: pushToken,
    push_env: "production",
    app_name: "Micro.blog for Android"
  }
})

Bookmarks and highlights

Bookmark screens load saved links, tags, recent tags, highlights, and per-bookmark metadata, then save tag changes back to Micro.blog.

5 endpoints

GET /posts/bookmarks/highlights

Lists saved highlights from bookmarked pages.

DELETE /posts/bookmarks/highlights/{id}

Deletes a saved highlight.

GET /posts/bookmarks/tags

Lists all bookmark tags and recent tags.

GET /posts/bookmarks/{id}

Loads one bookmark and its metadata.

POST /posts/bookmarks/{id}

Saves tag changes for one bookmark.

Source

bookmark_highlights src/api/MicroBlogApi.js:438 bookmark_tags src/api/MicroBlogApi.js:473 bookmark_by_id src/api/MicroBlogApi.js:513 save_tags_for_bookmark_by_id src/api/MicroBlogApi.js:532

Example

await axios.post(`/posts/bookmarks/${bookmarkId}`, "", {
  headers: { Authorization: `Bearer ${token}` },
  params: { tags: "api, mobile" }
})

IndieAuth and external blog protocols

The app can add external Micropub and XML-RPC services. For Micro.blog-hosted blogs, these same protocol endpoints are exposed by Micro.blog.

3 endpoints

GET /indieauth/auth

Starts the IndieAuth authorization flow for Micro.blog-hosted blogs.

POST /indieauth/token

Exchanges an authorization code for an access token.

POST /xmlrpc

Handles MetaWeblog-compatible XML-RPC calls for Micro.blog-hosted blogs.

Source

discover_micropub_endpoints src/api/MicroPubApi.js:28 make_auth_url src/api/MicroPubApi.js:92 verify_code src/api/MicroPubApi.js:114 xmlRpcCall src/api/XMLRPCApi.js:17

Example

const authUrl = `${authorizationEndpoint}?` + new URLSearchParams({
  me,
  client_id: "https://micro.blog/",
  redirect_uri: "https://micro.blog/indieauth/redirect",
  response_type: "code",
  scope: "create"
})

Notes and read-later client

Strata

Strata is a React Native app for Micro.blog notes, notebooks, bookmarks, highlights, and lightweight posting. It uses the Micro.blog notes APIs for encrypted note storage and Micropub for publishing and saving bookmark entries.

microdotblog/strata

React Native Fetch API Notes Bookmarks Micropub

src/api/MicroBlogApi.js

Micro.blog REST endpoints for sign-in, encrypted notes, notebooks, bookmarks, tags, and highlights.

src/api/MicroPubApi.js

Micropub configuration, category and syndication queries, publishing, post updates, and bookmark entries.

Strata

Notes and read-later client

4 flows 16 endpoints

Sign in and token verification

Strata signs in through the Micro.blog account endpoints, using a custom redirect URL and app name for email sign-in.

2 endpoints

POST /account/signin

Sends the email sign-in link for Strata's custom URL scheme.

POST /account/verify

Verifies a Micro.blog app token and returns account information.

Source

login_with_token src/api/MicroBlogApi.js:17 login_with_email src/api/MicroBlogApi.js:38

Example

const params = new URLSearchParams({
  email,
  redirect_url: "strata://signin/",
  app_name: "Strata"
})

await fetch(`https://micro.blog/account/signin?${params}`, {
  method: "POST"
})

Encrypted notes and notebooks

The notes screens list notebooks, fetch notebook feeds, create or rename notebooks, save encrypted note text, share or unshare notes, and delete notes.

6 endpoints

GET /notes/notebooks

Lists notebooks for the signed-in user.

POST /notes/notebooks

Creates a notebook or renames an existing notebook.

GET /notes/notebooks/{id}

Loads notes in a notebook, including paginated fetches with count and offset.

DELETE /notes/notebooks/{id}

Deletes a notebook.

POST /notes

Creates, edits, shares, unshares, or encrypts a note.

DELETE /notes/{note_id}

Deletes a note by ID.

Source

fetch_notebooks src/api/MicroBlogApi.js:71 fetch_notes_paginated src/api/MicroBlogApi.js:113 post_note src/api/MicroBlogApi.js:159 create_or_rename_notebook src/api/MicroBlogApi.js:215

Example

const form = new FormData()
form.append("text", encryptedText)
form.append("notebook_id", notebookId)
form.append("is_encrypted", true)

await fetch("https://micro.blog/notes", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: form
})

Bookmarks, tags, and highlights

Strata's read-later views load bookmark feeds, filter by tag, update bookmark tags, delete bookmarks, fetch recent tags, list highlights, and delete highlights.

6 endpoints

GET /posts/bookmarks

Loads saved bookmarks, optionally filtered by tag or before_id.

DELETE /posts/bookmarks/{id}

Deletes a saved bookmark.

GET /posts/bookmarks/tags

Lists all tags or recent tags for bookmark filtering.

POST /posts/bookmarks/{id}

Saves tag changes for one bookmark.

GET /posts/bookmarks/highlights

Lists highlights extracted from bookmarked pages.

DELETE /posts/bookmarks/highlights/{id}

Deletes a saved highlight.

Source

get_bookmarks src/api/MicroBlogApi.js:289 delete_bookmark src/api/MicroBlogApi.js:313 get_highlights src/api/MicroBlogApi.js:354 delete_highlight src/api/MicroBlogApi.js:371 save_tags_for_bookmark src/api/MicroBlogApi.js:409

Example

await fetch(`https://micro.blog/posts/bookmarks/${bookmarkId}?tags=${tags}`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})

Micropub posting and bookmark creation

Strata uses Micropub to read posting configuration, categories, and syndication targets, publish posts, update posts, and create bookmark entries from URLs.

2 endpoints

GET /micropub

Reads Micropub config, categories, and syndication targets.

POST /micropub

Publishes posts, updates posts, and saves bookmark-of entries.

Source

get_config src/api/MicroPubApi.js:12 send_post src/api/MicroPubApi.js:30 get_categories src/api/MicroPubApi.js:95 get_syndicate_to src/api/MicroPubApi.js:116 send_entry src/api/MicroPubApi.js:137 post_update src/api/MicroPubApi.js:183

Example

const form = new FormData()
form.append("h", "entry")
form.append("bookmark-of", url)
form.append("mp-destination", destination)

await fetch("https://micro.blog/micropub", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: form
})

Reader and read-later client

Inkwell

Inkwell is a React Native reader app for Micro.blog feeds, subscriptions, read state, bookmarks, highlights, conversations, and AI-powered recaps. It uses IndieAuth for sign-in and the Feedbin-compatible Micro.blog reader APIs for timeline and subscription workflows.

microdotblog/inkwell-react

React Native Expo AuthSession MobX State Tree Feeds IndieAuth

src/api/MicroBlogAuth.js

IndieAuth URL construction, code exchange, token verification, and session normalization.

src/api/MicroBlogFeeds.js

Feed subscriptions, entries, unread/starred state, bookmarks, highlights, conversation replies, and reader recaps.

Inkwell

Reader and read-later client

5 flows 26 endpoints

IndieAuth sign in and token verification

Inkwell starts with an IndieAuth authorization URL, exchanges the callback code for an access token, then verifies that token with Micro.blog account metadata.

3 endpoints

GET /indieauth/auth

Opens the authorization screen with Inkwell's client ID, redirect URL, scope, and state.

POST /indieauth/token

Exchanges the IndieAuth callback code for a Micro.blog access token.

POST /account/verify

Verifies the access token and reads profile, plan, and Inkwell capability fields.

Source

build_micro_blog_auth_url src/api/MicroBlogAuth.js:17 exchange_micro_blog_code src/api/MicroBlogAuth.js:72 verify_micro_blog_token src/api/MicroBlogAuth.js:100

Example

const tokenPayload = await exchange_micro_blog_code({
  code,
  redirect_uri: "inkwell://auth/callback",
  client_id: "https://micro.ink/client.json"
})

const profile = await verify_micro_blog_token(tokenPayload.access_token)

Subscriptions and feed timeline

The main feed loads subscriptions, feed icons, timeline pages, and entries for a single subscription, while subscription management creates, renames, and deletes followed feeds.

7 endpoints

GET /feeds/v2/subscriptions.json

Lists subscriptions, including the extended mode used by Inkwell.

POST /feeds/v2/subscriptions.json

Adds a feed URL to the reader subscriptions.

PATCH /feeds/v2/subscriptions/{id}.json

Renames an existing subscription.

DELETE /feeds/v2/subscriptions/{id}.json

Removes a subscription.

GET /feeds/v2/entries.json

Loads paginated timeline entries for the main reader feed.

GET /feeds/v2/feeds/{id}/entries.json

Loads paginated entries for one feed subscription.

GET /feeds/v2/icons.json

Fetches feed icons used in subscription and timeline UI.

Source

fetch_micro_blog_feed_subscriptions src/api/MicroBlogFeeds.js:13 create_micro_blog_feed_subscription src/api/MicroBlogFeeds.js:22 fetch_micro_blog_feed_entries src/api/MicroBlogFeeds.js:95 fetch_micro_blog_feed_entries_for_feed src/api/MicroBlogFeeds.js:149 update_micro_blog_feed_subscription src/api/MicroBlogFeeds.js:214 delete_micro_blog_feed_subscription src/api/MicroBlogFeeds.js:243

Example

const params = new URLSearchParams({
  per_page: "50",
  page: String(page)
})

const response = await fetch(`https://micro.blog/feeds/v2/entries.json?${params}`, {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`
  }
})

const entries = await response.json()

Read state and saved reader entries

Inkwell keeps reader state in sync by loading unread and starred entry IDs, marking entries read or unread, and starring or unstarring entries from the timeline.

6 endpoints

GET /feeds/v2/unread_entries.json

Loads IDs for unread entries.

POST /feeds/v2/unread_entries.json

Marks entries unread.

DELETE /feeds/v2/unread_entries.json

Marks entries read.

GET /feeds/v2/starred_entries.json

Loads IDs for starred reader entries.

POST /feeds/v2/starred_entries.json

Stars reader entries.

DELETE /feeds/v2/starred_entries.json

Unstars reader entries.

Source

fetch_micro_blog_feed_unread_entry_ids src/api/MicroBlogFeeds.js:192 fetch_micro_blog_feed_starred_entry_ids src/api/MicroBlogFeeds.js:200 mark_micro_blog_feed_entries_read src/api/MicroBlogFeeds.js:520 mark_micro_blog_feed_entries_unread src/api/MicroBlogFeeds.js:549 bookmark_micro_blog_feed_entries src/api/MicroBlogFeeds.js:578 unbookmark_micro_blog_feed_entries src/api/MicroBlogFeeds.js:607

Example

await fetch("https://micro.blog/feeds/v2/unread_entries.json", {
  method: "DELETE",
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ unread_entries: entryIds })
})

Bookmarks and highlights

The bookmark and highlight views load saved items, create new bookmark entries through Micropub, delete saved bookmarks, and create or delete reader highlights tied to feed entries.

6 endpoints

GET /posts/bookmarks

Loads saved bookmark entries.

POST /micropub

Creates bookmark-of Micropub entries for new saved links.

DELETE /posts/bookmarks/{id}

Deletes saved bookmarks.

GET /feeds/highlights

Lists reader highlights across saved feed entries.

POST /feeds/{entry_id}/highlights

Creates a highlight for a reader entry, with optional text offsets.

DELETE /feeds/{entry_id}/highlights/{highlight_id}

Deletes one reader highlight.

Source

fetch_micro_blog_bookmarks src/api/MicroBlogFeeds.js:295 fetch_micro_blog_highlights src/api/MicroBlogFeeds.js:301 create_micro_blog_highlight src/api/MicroBlogFeeds.js:307 delete_micro_blog_highlight src/api/MicroBlogFeeds.js:382 create_micro_blog_bookmark src/api/MicroBlogFeeds.js:757 delete_micro_blog_bookmark src/api/MicroBlogFeeds.js:806

Example

const body = new URLSearchParams({
  "bookmark-of": bookmarkUrl
})

await fetch("https://micro.blog/micropub", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/x-www-form-urlencoded"
  },
  body: body.toString()
})

Reader detail, replies, and recaps

Entry detail screens can load Micro.blog conversation replies, request a generated reader recap, and read or update the weekly recap email setting.

4 endpoints

GET /conversation.js

Loads Micro.blog conversation replies for a source URL.

POST /feeds/recap

Queues or returns an HTML recap for selected reader entries.

GET /feeds/recap/email

Reads the weekly recap email setting.

POST /feeds/recap/email

Updates the weekly recap email day.

Source

fetch_micro_blog_conversation_replies src/api/MicroBlogFeeds.js:440 summarize_micro_blog_feed_entries src/api/MicroBlogFeeds.js:636 fetch_recap_email_settings src/api/MicroBlogFeeds.js:691 update_recap_email_settings src/api/MicroBlogFeeds.js:701

Example

const response = await fetch("https://micro.blog/feeds/recap", {
  method: "POST",
  headers: {
    Accept: "text/html",
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify(entryIds)
})

Books and reading companion

Epilogue

Epilogue is a React Native companion app for Micro.blog bookshelves. It signs in with Micro.blog, manages books and reading goals, saves encrypted notes for books, publishes book posts through Micropub, and explores movie and TV posting helpers.

microdotblog/epilogue

React Native Bookshelves Notes Micropub Movies

src/screens/SignInScreen.js

Email sign-in, token paste-in, and Sign in with Apple.

src/screens/HomeScreen.js

Token verification, Micropub configuration, bookshelf loading, and book removal.

src/screens/BookDetailsScreen.js

Book notes, bookshelf assignment, and copying search results into a bookshelf.

src/screens/PostScreen.js

Micropub post creation and update requests for book posts and reading goals.

src/models/Book.js

Micro.blog book search and Open Library fallback search.

src/screens/MoviesScreen.js

Movie and TV discovery plus search results for posting.

Epilogue

Books and reading companion

6 flows 26 endpoints

Sign in and external blog authorization

Epilogue supports Micro.blog email sign-in, Sign in with Apple, pasted app tokens, and IndieAuth authorization for external Micropub blogs.

5 endpoints

POST /account/signin

Sends an email sign-in link that returns to Epilogue's custom URL scheme.

POST /account/apple

Verifies the Apple identity token and returns account or setup information.

POST /account/verify

Verifies pasted or redirected Micro.blog app tokens before loading app data.

GET /indieauth/auth

Starts the IndieAuth flow for Micro.blog-hosted blogs when adding an external blog.

POST /indieauth/token

Exchanges the IndieAuth callback code for a Micropub access token.

Source

sign_in_with_apple src/screens/SignInScreen.js:65 send_email_sign_in src/screens/SignInScreen.js:121 redeem_auth_code src/screens/HomeScreen.js:151 verify_token src/screens/HomeScreen.js:188 start_authorization src/screens/ExternalScreen.js:117

Example

const form = new FormData()
form.append("email", email)
form.append("app_name", "Epilogue")
form.append("redirect_url", "epilogue://signin/")

await fetch("https://micro.blog/account/signin", {
  method: "POST",
  body: form
})

Bookshelves and reading progress

The main bookshelf UI lists shelves and books, copies search results into a shelf, moves existing books, removes books, saves finished dates, and updates custom covers.

7 endpoints

GET /books/bookshelves

Lists the signed-in user's bookshelves and shelf counts.

GET /books/bookshelves/{id}

Loads the books in the selected bookshelf.

POST /books

Creates a book from search or discovery metadata and adds it to a bookshelf.

POST /books/bookshelves/{bookshelf_id}/assign

Moves or assigns an existing book to another bookshelf.

DELETE /books/bookshelves/{bookshelf_id}/remove/{book_id}

Removes a book from the current bookshelf.

POST /books/bookshelves/{bookshelf_id}/save/{book_id}

Saves the finished date for a book.

POST /books/bookshelves/{bookshelf_id}/cover/{book_id}

Updates a book's cover URL from the Open Library cover picker.

Source

load_books src/screens/HomeScreen.js:283 load_bookshelves src/screens/HomeScreen.js:316 remove_from_bookshelf src/screens/HomeScreen.js:497 assign_to_bookshelf src/screens/BookDetailsScreen.js:193 copy_to_bookshelf src/screens/BookDetailsScreen.js:218 save_finished_date src/screens/DateScreen.js:83 update_cover src/screens/OpenCoversScreen.js:102

Example

const form = new FormData()
form.append("book_id", bookId)

await fetch(`https://micro.blog/books/bookshelves/${bookshelfId}/assign`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: form
})

Book discovery, goals, and Open Library

Epilogue searches Micro.blog's book index, shows recently discovered book posts, loads reading goals, edits goal targets, and requests an Open Library session for cover browsing.

6 endpoints

GET /books/search

Searches Micro.blog's book index and returns JSON Feed results.

GET /posts/discover/books

Loads the public book discovery feed.

GET /books/goals

Lists the user's reading goals.

GET /books/goals/{id}

Loads the books counted toward one reading goal.

POST /books/goals/{id}

Updates the target value or progress for a reading goal.

POST /books/openlibrary/signin

Returns an Open Library session value for cover browsing.

Source

search_micro_books src/models/Book.js:173 load_discovered_books src/screens/DiscoverScreen.js:114 load_goals src/screens/GoalsScreen.js:45 load_goal_books src/screens/EditGoalScreen.js:37 update_goal src/screens/EditGoalScreen.js:107 open_library_sign_in src/screens/OpenLibraryScreen.js:74

Example

const response = await fetch(
  `https://micro.blog/books/search?q=${encodeURIComponent(query)}&format=jsonfeed`,
  { headers: { Authorization: `Bearer ${token}` } }
)

const books = await response.json()

Book notes

Book detail screens fetch encrypted notes attached to an ISBN, decrypt them locally, and save new or edited encrypted notes back to Micro.blog.

2 endpoints

GET /notes/for_book

Fetches notes attached to a specific ISBN.

POST /notes

Creates or updates an encrypted note attached to a book.

Source

fetch_notes_for_book src/screens/BookDetailsScreen.js:117 save_note src/screens/NoteScreen.js:50

Example

const form = new FormData()
form.append("text", encryptedText)
form.append("is_encrypted", "1")
form.append("attached_book_isbn", isbn)

await fetch("https://micro.blog/notes", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: form
})

Micropub book posts

Epilogue reads Micropub configuration and source posts, then publishes new book posts, updates existing posts, and posts yearly reading-goal drafts.

2 endpoints

GET /micropub

Reads Micropub config and source posts for the selected blog.

POST /micropub

Publishes new book posts, updates existing posts, and posts reading-goal drafts.

Source

load_blogs src/screens/HomeScreen.js:247 load_posts src/screens/ProfileScreen.js:119 send_post src/screens/PostScreen.js:206 setup_post_draft src/screens/EditGoalScreen.js:81

Example

const form = new FormData()
form.append("h", "entry")
form.append("content", markdown)
form.append("mp-destination", blogId)

await fetch("https://micro.blog/micropub", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: form
})

Movies and TV discovery

Movie screens load recent movie activity, search TMDB-backed movie helpers, and expand TV shows into season and episode posting helpers.

4 endpoints

GET /movies/discover

Loads recent movie and TV activity in JSON Feed format.

GET /movies/search

Searches for movie and TV posting helpers.

GET /movies/discover/{id}

Lists seasons for a TMDB show.

GET /movies/discover/{id}/seasons/{number}

Lists episodes for a TV season.

Source

fetch_discover src/screens/MoviesScreen.js:87 fetch_search src/screens/MoviesScreen.js:124 fetch_seasons src/screens/TVSeasonsScreen.js:43 fetch_episodes src/screens/TVEpisodesScreen.js:44

Example

const params = new URLSearchParams({ q: query })

const response = await fetch(`https://micro.blog/movies/search?${params}`, {
  headers: { Authorization: `Bearer ${token}` }
})

const movies = await response.json()