Create Follow

Follow another user

POST /:projectId/users/:userId/follow

Create Follow

cURL

curl --request POST \
  --url https://api.replyke.com/api/v6/:projectId/users/:userId/follow

200

{
  "id": "<string>",
  "followerId": "<string>",
  "followedId": "<string>",
  "createdAt": "<string>"
}

Create a follow relationship between the authenticated user and another user. This establishes a one-way follow relationship where the authenticated user will follow the specified user.

Path Parameters

userId · string · required

ID of the user to follow

Response

id · string

Unique identifier for the follow relationship

followerId · string

ID of the user who is following (current authenticated user)

followedId · string

ID of the user being followed

createdAt · string

Timestamp when the follow relationship was created

Error Responses

Invalid User ID - 400 Bad Request

{
  "error": "Invalid or missing userId",
  "code": "follow/invalid-user-id"
}

Self-Follow Attempt - 400 Bad Request

{
  "error": "Cannot follow yourself",
  "code": "follow/self-follow"
}

User Not Found - 404 Not Found

{
  "error": "User not found",
  "code": "follow/user-not-found"
}

Already Following - 409 Conflict

{
  "error": "Already following this user",
  "code": "follow/already-following"
}

Server Error - 500 Internal Server Error

{
  "error": "Internal server error",
  "code": "follow/server-error"
}

---

Notes

• This endpoint creates a Follow relationship in the database
• Follows are one-way relationships that do not require approval
• Users cannot follow themselves
• Duplicate follow requests return a 409 status
• Rate limiting: 75 requests per 5 minutes