Social API reference

Social API · Notification-Preferences

get/v1/communities/{community_id}/actors/{actor_id}/notification-prefsAuth

List the actor's per-kind notification preferences. Synthesises `enabled=true` defaults for kinds the actor has not explicitly toggled.

Returns one row per known NotificationKind so the client UI can render every toggle without a separate catalogue lookup. Synthesised rows carry an epoch `updated_at`; explicit rows carry the real timestamp.

Path parameters

community_id*string

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

actor_id*string

Social actor UUID (returned from POST /actors).

Response · 200 Per-kind preferences.

data*array

One row per known NotificationKind. Kinds the actor has not explicitly toggled report `enabled=true` and an epoch `updated_at`, so the client always sees the full catalogue with effective state.

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/actors/{actor_id}/notification-prefs
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
      "kind": "follow",
      "enabled": true,
      "updated_at": "2026-05-01T12:00:00.000Z"
    }
  ]
}