Follow User

Make a list of users to start following a specific user.

Make a list of users start following a specific user

post

/v1/user/{uid}/follow

Path parameters

uidinteger · int64required

User ID as a decimal integer of the user to be followed

Header parameters

sessionTokenstringrequired

Session authentication token.

Body

followersinteger · int64[]

Example: [7215545058313,7215545078461]

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/user/{uid}/follow' \
  --header 'sessionToken: text' \
  --header 'Content-Type: application/json' \
  --data '{"followers":[7215545058313,7215545078461]}'

200

400

401

403

500

200

{
  "format": "TEXT",
  "message": "User(s) successfully added in the list of followers"
}

Success

🚧 Rules

• The Service Account should have the Role "User Provisioning" in order to make these changes for any user or itself.

• It is impossible for a user/service account to follow himself. The fact that the user/service account to follow (whose id is the uid from path param) is part of the list followers will not generate an error in the payload:

  • a 200 should still be received but the user/service account will not follow himself;

  • the other users included in the list will however start following the user to be followed (the one whose id is in path param as uid).

• If an invalid user id is part of the list followers, then:

  • a 400 error will be received in the payload mentioning the invalid user id;

  • the other users included in the list will however start following the user to be followed (the one whose id is in path param as uid).

• The fact that one of the user from the list followers already follows the considered user (from the path param as the one to follow) will not generate an error in the payload: a 200 should still be received. The involved user from the followers list will continue following the one to be followed.

When calling this as an OBO-enabled endpoint, use the OBO User Authenticate token for sessionToken.

📘 See also

• Unfollow User to make a list of users to stop following a specific user