Follow User

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

Make a list of users start following a specific user

POSTyourpodURL.symphony.com/pod/v1/user/{uid}/follow

Path parameters

uid*integer (int64)

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

Header parameters

Body

application/json

List of (integer) User IDs of the followers

followersUserIdList (array of integer (int64))

Response

200400401403500

Success

Body

application/json

formatenum

TEXTXML

messagestring

Request

JavaScriptCurl

const response = await fetch('yourpodURL.symphony.com/pod/v1/user/{uid}/follow', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "format": "TEXT",
  "message": "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