Reactions

Readers can react to comments. A reaction is a toggle: re-sending the same reaction type removes it, and sending a different type replaces it.

Toggle a reaction

POST /api/v1/comments/{commentId}/reactions
X-API-Key: ek_…
X-RSMG-Engage-Identity: <assertion>
X-RSMG-Engage-Identity-Signature: t=…,v1=…,kid=…
Content-Type: application/json

{ "reaction_type": "👍" }

The reacting reader comes from the identity assertion.

Read counts

GET /api/v1/comments/{commentId}/reactions
X-API-Key: ek_…

Returns aggregate counts per reaction type. Pass the viewer's assertion to also learn which types the current reader has applied.

Real-time echoes

A toggle emits a reaction_toggled SSE event. That event carries an externalUserId field — the reacting reader's external id — so a widget that knows readers only by your ids can suppress the echo of its own reader's action by matching externalUserId === <viewer external id>. See Real-time (SSE).

Full schemas are under Reactions in the API Reference.