Unfollow User

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

Make a list of users unfollowing a specific user

post

Path parameters

uidinteger · int64Required

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

Header parameters

sessionTokenstringRequired

Session authentication token.

Body

application/json

followersinteger · int64[]OptionalExample: [7215545058313,7215545078461]

Responses

200

Success

application/json

400

Client error, see response body for further details.

application/json

401

Unauthorized: Invalid session token.

application/json

403

Forbidden: Caller lacks necessary entitlement.

application/json

500

Server error, see response body for further details.

application/json

post

/v1/user/{uid}/unfollow

HTTPcURLJavaScriptPython

POST /pod/v1/user/{uid}/unfollow HTTP/1.1
Host: yourpodURL.symphony.com
sessionToken: text
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "followers": [
    7215545058313,
    7215545078461
  ]
}

{
  "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 unfollow (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 and nothing will happen regarding the affected user/service account;

  • the other users included in the list will however stop following the user to be unfollowed (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 stop following the user to be unfollowed (the one whose id is in path param as uid).

• The fact that one of the user from the list followers does not follow the considered user (whose id is the uid from path param as the one to unfollow) will not generate an error in the payload: a 200 should still be received. The involved user from the followers list will still be out of the list of followers of the user to unfollow.

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

📘 See also

• Follow User to make a list of users to start following a specific user