Social API reference

Social API · Notifications

post/v1/communities/{community_id}/actors/{actor_id}/notifications/read-allAuth

Mark every unread notification for the actor as read.

Single bulk write. Optional `before` ISO timestamp scopes to rows older than that — useful for "mark all older than today as read" UX. Returns the number of rows that flipped.

Path parameters

community_id*string

Community UUID.

actor_id*string

Social actor UUID (returned from POST /actors).

Request body

beforestring

Optional ISO timestamp; only flips rows older than this. Omit to flip all unread.

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

Response · 200 Bulk update applied; `updated` is the row count.

updated*number

Number of rows whose `read_at` flipped from null to now().

Example: 12

Example

Request

POST https://social.productcraft.co/v1/communities/{community_id}/actors/{actor_id}/notifications/read-all
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "before": "2026-05-01T00:00:00.000Z"
}

Response

{
  "updated": 12
}