Unfollow site

Namespace: microsoft.graph

Unfollow a user's site or multiple sites.

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Sites.ReadWrite.All
Delegated (personal Microsoft account) Not supported.
Application Sites.ReadWrite.All

HTTP request

POST /users/{user-id}/followedSites/remove

Request body

In the request body, supply an array of JSON objects with the id parameter mentioned in the table below.

Name Value Description
id string The unique identifier of the item.

Response

  • If the request is successful, this method returns a 204 status code with no content.
  • If an error occured while unfollowing any of the specified sites, this method returns a 207 status code and the response body will contain an array of entries containing error objects and siteIds indicating which sites unable to be unfollowed.

Example

The following example shows how to unfollow multiple sites.

Request

POST /users/{user-id}/followedSites/remove
Content-Type: application/json

{
    "value":
    [
        {
            "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740"
        },
        {
            "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851851"
        }
    ] 
}

Response

If successful, it returns the following JSON response.

HTTP/1.1 204 No Content

If an error occured, it returns the following JSON response

HTTP/1.1 207 Multi-Status
Content-type: application/json

{
    "value": [
        {
            "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,512a596e-90a1-49e3-9b48-bfa80bee8740",
            "error": {
                "@odata.type": "#oneDrive.error",
                "code": "invalidRequest",
                "message": "The site Id information that is provided in the request is incorrect",
                "innerError": {
                    "code": "invalidRequest",
                    "errorType": "expected",
                    "message": "The site Id information that is provided in the request is incorrect",
                    "stackTrace": "",
                    "throwSite": ""
                }
            }
        }
    ]
}