Follows
Follow and unfollow writers, and read follow status on MisarBlog.
First-party session route
Follows are a first-party route served by the MisarBlog app (https://api.misar.io/blog/follows), not part of the public api.misar.io/blog/v1 API-key surface. Follow and unfollow are authenticated with your logged-in session cookie plus a CSRF token — there is no Authorization: Bearer mbk_... on these endpoints. Reading follow status is public.
Follow relationships are keyed by profile UUID (following_id), not by username. Write operations (POST, DELETE) require a valid session cookie and a CSRF token in the X-CSRF-Token header (double-submit against the csrf_token cookie), and are rate-limited to 20 requests per minute per IP.
Get Follow Status
/blog/followsReturns follow status and counts for a given user. Public — no authentication required. Rate-limited to 60 requests per minute per IP.
Query parameters
user_idstringqueryrequiredUUID of the profile to read follow status for.
Response fields
isFollowingbooleanWhether the current session user follows this profile (false when signed out).
followerCountintegerNumber of accounts following this profile.
followingCountintegerNumber of accounts this profile follows.
curl "https://api.misar.io/blog/follows?user_id=550e8400-e29b-41d4-a716-446655440000"{
"isFollowing": true,
"followerCount": 2840,
"followingCount": 128
}Follow a Writer
/blog/followsFollow a writer by profile UUID. Requires a session cookie and the X-CSRF-Token header. Idempotent — following someone you already follow succeeds. You cannot follow yourself.
Request body
following_idstringbodyrequiredUUID of the profile to follow.
Response fields
successbooleantrue when the follow was recorded.
isFollowingbooleantrue after a successful follow.
curl -X POST "https://api.misar.io/blog/follows" \
-H "Content-Type: application/json" \
-H "X-CSRF-Token: $CSRF_TOKEN" \
--cookie "session=...; csrf_token=$CSRF_TOKEN" \
-d '{"following_id":"550e8400-e29b-41d4-a716-446655440000"}'{ "success": true, "isFollowing": true }Unfollow a Writer
/blog/followsUnfollow a writer you currently follow. Requires a session cookie and the X-CSRF-Token header. The profile UUID is passed in the request body.
Request body
following_idstringbodyrequiredUUID of the profile to unfollow.
Response fields
successbooleantrue when the unfollow was recorded.
isFollowingbooleanfalse after a successful unfollow.
curl -X DELETE "https://api.misar.io/blog/follows" \
-H "Content-Type: application/json" \
-H "X-CSRF-Token: $CSRF_TOKEN" \
--cookie "session=...; csrf_token=$CSRF_TOKEN" \
-d '{"following_id":"550e8400-e29b-41d4-a716-446655440000"}'{ "success": true, "isFollowing": false }Status codes
400— Missinguser_id/following_id, invalid UUID, not signed in, or attempting to follow yourself403— Invalid or missing CSRF token429— Rate limit exceeded (see theRetry-Afterheader)