Social API reference

Social API · Stories

post/v1/communities/{community_id}/posts/{post_id}/viewsAuth

Record a view of a post (idempotent).

Idempotent on `(community, viewer, post)`. 204 on success or no-op duplicate. 422 on self-view (you cannot view your own story). 404 if the post is hidden by visibility, expired, removed, or if a block exists between viewer and author. Does NOT fire a notification — the author sees views via the viewers endpoint instead.

Path parameters

community_id*string

Community UUID.

post_id*string

Story (post) UUID.

Request body

actor_id*string · uuid

Viewer social actor UUID. Standardized name (task 008 / G11).

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

Response · 204

View recorded (or already existed).

Example

Request

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

{
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000002"
}