# Account

Page: https://microblog.dev/api/account/
API base URL: https://micro.blog

Endpoints for account preferences and account-level API settings.

## Endpoints
### POST /account/feeds

URL: `https://micro.blog/account/feeds`

Adds a feed source to the account.




Query parameters:
- `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:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns an empty JSON object on success.
Example response:

```json
{}
```

### GET /account/info/domains

URL: `https://micro.blog/account/info/domains`

Returns hosted site and domain status information.






Header parameters:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON response.
Example response:

```json
[
  {
    "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

URL: `https://micro.blog/account/info/feeds`

Returns account feed and cross-posting source information.






Header parameters:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON response.
Example response:

```json
{
  "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

URL: `https://micro.blog/account/settings`

Returns account-level API settings for the authenticated user.






Header parameters:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns account settings.
Example response:

```json
{
  "timeline": 0
}
```

### POST /account/settings

URL: `https://micro.blog/account/settings`

Updates account-level API settings for the authenticated user.




Query parameters:
- `timeline` (integer, required): Timeline mention setting. `0` includes all posts, `1` limits mentions, and `2` hides mentions.
  Example: `2`



Header parameters:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns an empty JSON object on success.
Example response:

```json
{}
```