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
POST /account/feeds

Adds a feed source to the account.

Example Request

curl -X POST "https://micro.blog/account/feeds?url=https%3A%2F%2Fexample.com%2Fpost" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name Type Required Description
url string Required URL for the target resource.
Example: https://example.com/post
add_feed_option string Optional Optional add mode, for example import.
Example: import
site_id integer Optional Site identifier.
Example: 123

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.

Example Response

{}
GET /account/info/domains

Returns hosted site and domain status information.

Example Request

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

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

[
  {
    "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": "Apr 26, 2026"
  }
]
GET /account/info/feeds

Returns account feed and cross-posting source information.

Example Request

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

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",
      "nostr_pubkey": "",
      "youtube_channel_title": "",
      "pixelfed_username": "",
      "pixelfed_hostname": "",
      "peertube_username": "",
      "peertube_hostname": "",
      "has_crosspost_mastodon": true,
      "has_crosspost_bluesky": true,
      "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.

Example Request

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

Header Parameters

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

Response

200 OK application/json

Returns account settings.

Example Response

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

Updates account-level API settings for the authenticated user.

Example Request

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

Query Parameters

Name Type Required Description
timeline integer Required Timeline mention setting. 0 includes all posts, 1 limits mentions, and 2 hides mentions.
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.

Example Response

{}