Skip to content

site-unfollow.md

Latest commit

 

History

History
158 lines (117 loc) · 5.41 KB

site-unfollow.md

File metadata and controls

158 lines (117 loc) · 5.41 KB
author learafa
title Unfollow site
description Unfollow a user's site
ms.localizationpriority medium
ms.subservice sharepoint
doc_type apiPageType
ms.date 04/18/2024

Unfollow site

Namespace: microsoft.graph

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 headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json. Required.

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 occurred while unfollowing any of the specified sites, this method returns a 207 status code and the response body 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

HTTP

POST https://graph.microsoft.com/v1.0/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, it returns the following JSON response.

HTTP/1.1 204 No Content

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