# Mentions

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

Endpoints for mentions and blocked mention feeds.

## Endpoints
### GET /posts/mentions

URL: `https://micro.blog/posts/mentions`

Returns mentions for the authenticated user.




Query parameters:
- `since_id` (integer, optional): Only return posts newer than this post ID.
  Example: `10203852`
- `before_id` (integer, optional): Only return posts older than this post ID.
  Example: `9853826`
- `count` (integer, optional): Maximum number of items to return.
  Example: `5`



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




Example request:

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

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

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions",
  "items": []
}
```

### GET /posts/mentions/blocked

URL: `https://micro.blog/posts/mentions/blocked`

Returns blocked or hidden mentions for the authenticated user.




Query parameters:
- `since_id` (integer, optional): Only return posts newer than this post ID.
  Example: `10203852`
- `before_id` (integer, optional): Only return posts older than this post ID.
  Example: `9853826`
- `count` (integer, optional): Maximum number of items to return.
  Example: `5`



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




Example request:

```sh
curl -X GET "https://micro.blog/posts/mentions/blocked" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

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

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions/blocked",
  "items": []
}
```

### GET /posts/mentions/bluesky

URL: `https://micro.blog/posts/mentions/bluesky`

Returns Bluesky mentions in JSON Feed format.




Query parameters:
- `count` (integer, optional): count parameter.
  Example: `example`
- `since_id` (string, optional): Only return posts newer than this post ID.
  Example: `77479242`
- `before_id` (string, optional): Only return posts older than this post ID.
  Example: `9853826`



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




Example request:

```sh
curl -X GET "https://micro.blog/posts/mentions/bluesky" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

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

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```

### GET /posts/mentions/mastodon

URL: `https://micro.blog/posts/mentions/mastodon`

Returns Mastodon mentions in JSON Feed format.




Query parameters:
- `count` (integer, optional): count parameter.
  Example: `example`
- `since_id` (string, optional): Only return posts newer than this post ID.
  Example: `77479242`
- `before_id` (string, optional): Only return posts older than this post ID.
  Example: `9853826`



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




Example request:

```sh
curl -X GET "https://micro.blog/posts/mentions/mastodon" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

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

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```

### GET /posts/mentions/mb

URL: `https://micro.blog/posts/mentions/mb`

Returns Micro.blog mentions in JSON Feed format.




Query parameters:
- `count` (integer, optional): count parameter.
  Example: `example`
- `since_id` (string, optional): Only return posts newer than this post ID.
  Example: `77479242`
- `before_id` (string, optional): Only return posts older than this post ID.
  Example: `9853826`



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




Example request:

```sh
curl -X GET "https://micro.blog/posts/mentions/mb" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

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

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```

### POST /posts/mentions/{id}

URL: `https://micro.blog/posts/mentions/{id}`

Updates mention visibility metadata.


Path parameters:
- `id` (integer, required): Resource identifier.
  Example: `12345`



Query parameters:
- `is_hidden_for_blog` (integer, optional): Whether a mention should be hidden from the blog.
  Example: `1`



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




Example request:

```sh
curl -X POST "https://micro.blog/posts/mentions/{id}" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

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

```json
{}
```