Follow this user

POST

/users/{ref}/follow

• Local development behind nginx (port 8088 by default)

Directional follow. Idempotent: re-following someone you already follow returns 204 too. Self-follow is rejected with 400. Cross-block-edge follow (either party has blocked the other) is rejected with 403 — modern platforms treat blocks as a hard interaction stop.

Wires the long-parked posts.visibility='followers' gate. The browse-feed “Following” tab also activates the moment any follow row exists.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

ref

required

integer format: int64

Responses

204

Now following (or was already).

400

Malformed request

object

error

required

Human-readable error summary

string

Example

the request could not be completed

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed