Block this user
POST /users/{ref}/block
POST
/users/{ref}/block
Directional block. Auto-unfollows BOTH
directions before persisting the block (continuing to
follow a blocked user is a contradictory state, so the
block implies a follower-graph cleanup). The optional
reason is private to the blocker, surfaced only in
/account/blocked.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” ref
required
integer format: int64
Request Body
Section titled “Request Body ”Optional reason recorded with the block.
object
reason
Private note visible only to the blocker in /account/blocked. Surfaced verbatim. Empty/omitted is fine — most blocks don’t carry a reason.
string
Responses
Section titled “ Responses ”Block recorded (or already in place).
Malformed request
object
error
required
Human-readable error summary
string
Example
the request could not be completedAuthentication required, missing, or invalid
object
error
required
Human-readable error summary
string
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Resource not found
object
error
required
Human-readable error summary
string
Example
the request could not be completed