Social API reference

Social API · Conversations

post/v1/communities/{community_id}/conversations/{conversation_id}/readAuth

Mark messages as read up to a given timestamp (default: now()). Sets the caller's `last_read_at`.

Path parameters

community_id*string

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

conversation_id*string

Conversation UUID.

Request body

actor_id*string · uuid

The reader — social actor UUID.

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

read_throughstring

ISO timestamp. Messages with `created_at <= read_through` count as read. Omit to mark every message up to now().

Example: "2026-05-01T12:00:00.000Z"

Response · 204

Read marker updated.

Example

Request

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

{
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "read_through": "2026-05-01T12:00:00.000Z"
}