Social API reference

Social API · Edges

get/v1/communities/{community_id}/actors/{src_actor_id}/relationshipsAuth

Batched pairwise relationship lookup: does this actor follow / mute / block / restrict each of up to 100 others (and is it followed / blocked back)?

One query resolves the seven pairwise flags for a whole profile header or member list — no paging of full edge lists, and `blocked_by` is visible without attempting a write and handling the 409. Unknown or cross-community ids resolve to all-false flags; the id list is de-duplicated preserving request order. Bounded input (max 100 ids), so the response has no pagination envelope.

Path parameters

community_id*string

Social community UUID. Must belong to the PAK's workspace.

src_actor_id*string

Source actor UUID — the perspective all flags are computed from.

Query parameters

with*string

Comma-separated destination actor UUIDs (1-100).

Response · 200 One relationship entry per requested id.

data*array

One entry per requested id (de-duplicated, request order). Unknown ids resolve to all-false flags.

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/actors/{src_actor_id}/relationships
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "dst_actor_id": "aaaaaaaa-0000-0000-0000-000000000002",
      "following": true,
      "followed_by": false,
      "muting": false,
      "blocking": false,
      "blocked_by": false,
      "restricting": false,
      "close_friend": false,
      "follow_pending": false
    }
  ]
}