Build with Micro.blog logo
Build with Micro.blog
API Documentation

Account

View .md

Endpoints for account preferences and account-level API settings.

BASE URL https://micro.blog
GET /account/info/domains

Returns the user’s hosted sites with their custom domain and subscription status. Requires the read scope.

Example Request

curl -X GET "https://micro.blog/account/info/domains" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Response

200 OK application/json

Returns an array of sites. status is free, paid, expired, expires today, or the number of days left, such as 12 days left. ssl_status describes the custom domain certificate and can be null.

Example Response

[
  {
    "id": 789,
    "guid": "vincent",
    "hostname": "vincent.micro.blog",
    "cname": "www.example.com",
    "url": "https://vincent.micro.blog/",
    "status": "paid",
    "has_cname": true,
    "is_paid": true,
    "is_expired": false,
    "ssl_status": "ready",
    "created_at": "2026-04-26"
  }
]
GET /account/info/feeds

Returns the feeds the user has added as sources, with the cross-posting services connected to each one. Requires the read scope.

Example Request

curl -X GET "https://micro.blog/account/info/feeds" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Response

200 OK application/json

Returns a JSON response.

Example Response

{
  "rss_feeds": [
    {
      "id": 123,
      "url": "https://vincent.example.com/feed.json",
      "twitter_username": "",
      "medium_username": "",
      "mastodon_username": "vincent",
      "mastodon_hostname": "mastodon.social",
      "tumblr_hostname": "",
      "flickr_username": "",
      "facebook_name": "",
      "facebook_page": "",
      "linkedin_name": "",
      "bluesky_handle": "vincent.example.com",
      "grain_auth_source": "",
      "dayone_email": "",
      "nostr_pubkey": "",
      "threads_username": "",
      "youtube_channel_title": "",
      "pixelfed_username": "",
      "pixelfed_hostname": "",
      "peertube_username": "",
      "peertube_hostname": "",
      "has_crosspost_twitter": false,
      "has_crosspost_medium": false,
      "has_crosspost_linkedin": false,
      "has_crosspost_facebook": false,
      "has_crosspost_mastodon": true,
      "has_crosspost_tumblr": false,
      "has_crosspost_flickr": false,
      "has_crosspost_bluesky": true,
      "has_crosspost_grain": false,
      "has_crosspost_dayone": false,
      "has_crosspost_nostr": false,
      "has_crosspost_threads": false,
      "has_crosspost_youtube": false,
      "has_crosspost_pixelfed": false,
      "has_crosspost_peertube": false,
      "has_crosspost_any": true,
      "has_bot": false,
      "has_error": false,
      "refresh_error": "",
      "is_disabled_crossposting": false,
      "is_importer": false,
      "import_feed_hostname": "vincent.example.com",
      "import_blog_hostname": ""
    }
  ],
  "new_feed": {
    "id": 0,
    "url": ""
  }
}
GET /account/settings

Returns account-level API settings for the authenticated user. Requires the read scope.

Example Request

curl -X GET "https://micro.blog/account/settings" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Response

200 OK application/json

Returns account settings. timeline is 0 to show all posts and replies in the timeline, 1 to show only replies to people the user follows, or 2 to hide replies.

Example Response

{
  "timeline": 0
}
POST /account/settings

Updates account-level API settings for the authenticated user. Requires the write scope.

Example Request

curl -X POST "https://micro.blog/account/settings?timeline=2" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Query Parameters

Name Type Required Description
timeline integer Required Timeline reply setting. 0 shows all posts and replies, 1 shows only replies to people the user follows, and 2 hides replies. Always send it, because a request without it resets the setting to 0.
Example: 2

Header Parameters

Name Type Required Description
Authorization string Required Bearer token for authentication. Format: Bearer {token}.

Response

200 OK application/json

Returns an empty JSON object on success, or 406 when timeline is not 0, 1, or 2.

Example Response

{}