Social API reference

Social API · Stories

post/v1/communities/{community_id}/close-friendsAuth

Add a member to an actor's close-friends list.

Idempotent on `(community, owner, member)`. 422 on self-add. 409 if a block exists between the pair in either direction. Visibility-`close_friends` posts authored by `owner` become visible to `member` after this call.

Path parameters

community_id*string

Community UUID.

Headers

Idempotency-Keystring

Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.

Request body

actor_idstring · uuid

The acting actor, whose close-friends list this is. Send it, or the deprecated `owner_actor_id`; one of the two is required.

Example: "aaaaaaaa-0000-0000-0000-000000000001"

owner_actor_idstring · uuid

Deprecated alias of `actor_id`; send `actor_id`.

Example: "aaaaaaaa-0000-0000-0000-000000000001"

member_actor_id*string · uuid

Member social actor UUID (the actor being added).

Example: "aaaaaaaa-0000-0000-0000-000000000002"

Response · 204

Member added (or already present).

Example

Request

POST https://social.productcraft.co/v1/communities/{community_id}/close-friends
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "owner_actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "member_actor_id": "aaaaaaaa-0000-0000-0000-000000000002"
}