Graph API Version

ThreatPrivacyGroup

Represents a mutable list of ThreatExchangeMembers to which data can be shared, alongside metadata and privacy rules. Only available in versions 2.4+ of the Graph API.

Fields

ParameterDescriptionType

id

Unique identifier of the threat privacy group

number

name

The name of the threat privacy group

string

description

A human readable description of the group

string

members_can_see

If true, group members can view this group, including its name, description, and list of members

boolean

members_can_use

If true, members are allowed to use this group to protect their own threat data

boolean

Sample Usage

To create a privacy group, one could POST to:

https://graph.facebook.com/v2.7/threat_privacy_groups?name=GROUP1&description=MYFIRSTGROUP&access_token=555|asdF123

Data returned:

{
  "id": "123456789101112"
}

To change the members list for that privacy group, POST to the corresponding node (this can be used to either add or remove members from the group):

https://graph.facebook.com/v2.7/123456789101112?members=820763734618599,<another-app-id>

Data returned:

{
  "success": true
}

Connections

NameDescriptionType

members

Members of the privacy group

ThreatExchangeMember

Sample Usage

Example query for a specific privacy group: 123456789101112

https://graph.facebook.com/v2.7/123456789101112/members/?access_token=555|aSdF123GhK

Data returned:

{
  "data": [
    {
      "id": "999999999999",
      "email": "threatexchange@domain.com",
      "name": "Facebook Administrator"
    }
    ...
  ]
}