Skip to content

site-unfollow.md

Latest commit

 

History

History
154 lines (113 loc) · 5.25 KB

site-unfollow.md

File metadata and controls

154 lines (113 loc) · 5.25 KB
author learafa
title Unfollow site
description Unfollow a user's site.
ms.localizationpriority medium
ms.subservice sharepoint
doc_type apiPageType
ms.date 04/19/2024

Unfollow site

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Unfollow a user's site or multiple sites.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

HTTP request

POST /users/{id | userPrincipalName}/followedSites/remove

Request body

In the request body, supply an array of JSON objects with the id parameter.

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 occurred while unfollowing any of the specified sites, this method returns a 207 status code and the response body contains an array of entries that contain error objects and site IDs that indicate which sites were not unfollowed.

Example

The following example shows how to unfollow multiple sites.

Request

HTTP

POST https://graph.microsoft.com/beta/users/87d349ed-44d7-43e1-9a83-5f2406dee5bd/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"
        }
    ] 
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

If successful, the request returns the following response.

HTTP/1.1 204 No Content

If an error occurred, the request 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": ""
                }
            }
        }
    ]
}