Graph API Version

Users or Pages Blocked from a Page

This edge is for managing the set of people or pages blocked from a page. All of these methods require a Page Access Token.

Reading

User or Page Profiles blocked from this Page

Graph API Explorer
GET /v2.10/{page-id}/blocked HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{page-id}/blocked'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "/{page-id}/blocked",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/blocked",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/blocked"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps
No data
Page management Apps
  • manage_pages
  • pages_show_list
Other Apps
No data

Parameters

NameDescription
uid
int

uid

user
int

user

Fields

Reading from this edge will return a JSON formatted result:

{ "data": [], "paging": {} }

data

A list of Profile nodes.

paging

For more details about pagination, see the Graph API guide.

Validation Rules

ErrorDescription
200Permissions error
210User not visible
100Invalid parameter

Creating

You can make a POST request to blocked edge from the following paths:
When posting to this edge, no Graph object will be created.

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps
No data
Page management Apps
  • manage_pages
  • pages_show_list
Other Apps
No data

Parameters

NameDescription
asid
list<>

List of App Scoped User IDs to block

uid
list<numeric string>

Deprecated. Same as user

user
list<numeric string>

List of User or Page IDs to block. This or uid is required

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.
Map {
numeric string: bool
}

Validation Rules

ErrorDescription
100Invalid parameter
200Permissions error
210User not visible

Updating

You can't perform this operation on this endpoint.

Deleting

You can dissociate a User from a Page by making a DELETE request to /{page_id}/blocked.

Parameters

NameDescription
asid
int

AppScopedUserID to unblock

uid
int

Deprecated. Same as user

user
int

List of User or Page IDs to unblock. This or uid is required

Return Type

Struct {
success: bool,
}

Validation Rules

ErrorDescription
100Invalid parameter