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

Markers

View .md

Endpoints for reading and updating timeline marker positions.

BASE URL https://micro.blog
GET /posts/check

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

Example Request

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

Query Parameters

Name Type Required Description
since_id integer Optional Only return posts newer than this post ID.
Example: 77479242

Header Parameters

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

Response

200 OK application/json

Returns marker and publishing state.

Example Response

{
  "count": 0,
  "check_seconds": 20,
  "markers": {},
  "is_publishing": false,
  "is_processing": false,
  "publishing_progress": 0,
  "publishing_status": "",
  "latest_url": ""
}
POST /posts/markers

Stores a marker position for a timeline channel.

Example Request

curl -X POST "https://micro.blog/posts/markers?channel=timeline&id=example&date_marked=2026-04-26T12%3A00%3A00Z" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name Type Required Description
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

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

{}