Follows is currently an internal API. The endpoints below document the planned public v1 shape. Will be promoted to public v1 API in a future release.

Follow a Writer

POST/v1/follows

Follow a writer by username. Requires authentication via Authorization: Bearer mbk_YOUR_API_KEY.

Request body

usernamestringbodyrequired

Username of the writer to follow.

Response fields

followingstring

Username of the writer now followed.

followed_atstring

ISO 8601 timestamp when the follow was created.

curl -X POST "https://api.misar.io/blog/v1/follows" \
  -H "Authorization: Bearer mbk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"johndoe"}'

{
  "following": "johndoe",
  "followed_at": "2026-04-16T10:30:00Z"
}

Unfollow a Writer

DELETE/v1/follows/:username

Unfollow a writer you currently follow. Requires authentication.

Path parameters

usernamestringpathrequired

Username of the writer to unfollow.

curl -X DELETE "https://api.misar.io/blog/v1/follows/johndoe" \
  -H "Authorization: Bearer mbk_YOUR_KEY"

List Follows

GET/v1/follows

Returns the list of writers you follow. Requires authentication.

Query parameters

limitintegerquerydefault: 20

Results per page (max 100).

offsetintegerquerydefault: 0

Pagination offset.

Response fields

dataArray<object>

The page of followed writers. Each entry includes username, display_name, avatar_url, bio, follower_count, followed_at, and profile_url.

totalinteger

Total number of writers you follow.

limitinteger

Results per page applied.

offsetinteger

Pagination offset applied.

curl "https://api.misar.io/blog/v1/follows" \
  -H "Authorization: Bearer mbk_YOUR_KEY"

{
  "data": [
    {
      "username": "johndoe",
      "display_name": "John Doe",
      "avatar_url": "https://supabase-blog.misar.io/storage/v1/object/public/avatars/johndoe.jpg",
      "bio": "Full-stack engineer. Writing about React, AI, and distributed systems.",
      "follower_count": 2840,
      "followed_at": "2026-04-10T08:00:00Z",
      "profile_url": "https://www.misar.blog/@johndoe"
    }
  ],
  "total": 12,
  "limit": 20,
  "offset": 0
}

const headers = { Authorization: `Bearer ${process.env.MISARBLOG_API_KEY}` };

// Follow
await fetch("https://api.misar.io/blog/v1/follows", {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ username: "johndoe" }),
});

// Unfollow
await fetch("https://api.misar.io/blog/v1/follows/johndoe", {
  method: "DELETE",
  headers,
});

// List follows
const res = await fetch("https://api.misar.io/blog/v1/follows", { headers });
const { data, total } = await res.json();

Errors

Status	Description
`401`	Invalid or missing API key
`404`	Writer with given username not found
`409`	Already following this writer (on follow)