# Markers

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

Endpoints for reading and updating timeline marker positions.

## Endpoints
### GET /posts/check

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

Checks for new timeline posts, publishing state, media processing state, and saved marker positions.




Query parameters:
- `since_id` (integer, optional): Only return posts newer than this post ID.
  Example: `77479242`



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/check" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns marker and publishing state.
Example response:

```json
{
  "count": 0,
  "check_seconds": 20,
  "markers": {},
  "is_publishing": false,
  "is_processing": false,
  "publishing_progress": 0,
  "publishing_status": "",
  "latest_url": ""
}
```

### POST /posts/markers

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

Stores a marker position for a timeline channel.




Query parameters:
- `channel` (string, required): Marker channel name.
  Example: `timeline`
- `id` (integer, required): Identifier for the resource.
  Example: `12345`
- `date_marked` (string, required): ISO 8601 timestamp for the marker position.
  Example: `2026-04-26T12:00:00Z`



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/markers?channel=timeline&id=example&date_marked=2026-04-26T12%3A00%3A00Z" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"
```

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

```json
{}
```