Social API reference

Social API · Notifications

patch/v1/communities/{community_id}/actors/{actor_id}/notifications/{notification_id}Auth

Mark a single notification as read or unread.

Idempotent: marking an already-read row read again is a no-op 204. Returns 404 if the notification belongs to a different actor.

Path parameters

community_id*string

Community UUID.

actor_id*string

Social actor UUID (returned from POST /actors).

notification_id*string

Notification UUID returned from the list endpoint.

Request body

read*boolean

`true` to mark read, `false` to mark unread.

Example: true

Response · 204

Read state updated.

Example

Request

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

{
  "read": true
}