signals

Set Signal Reaction

Set (or replace) the calling user's reaction on a signal. Reactions are keyed on the signal's stable fingerprint, so a reaction survives the nightly re-detection of the same underlying issue.

Requires a user token (JWT) — API keys have no user identity to attribute the reaction to and receive 403.

put/{brand_id}/signals/{signal_id}/reaction

Path parameters

brand_idinteger required

signal_idinteger required

Request body

reaction'useful' | 'not_useful' | 'dismissed' | 'actioned' required

Reaction to set: useful, not_useful, dismissed, or actioned.

reasonstring nullable

Optional free-text reason accompanying the reaction.

Response

Successful Response

user_idinteger required

ID of the user the reaction belongs to.

insight_idinteger required

Signal ID the reaction was last set on.

fingerprintstring required

Stable signal identity the reaction follows across re-detections.

reaction'useful' | 'not_useful' | 'dismissed' | 'actioned' required

The reaction value.

reasonstring nullable

Free-text reason, when provided.

surface'in_app' | 'email' | 'slack' | 'api' required

Where the reaction was set: in_app, email, slack, or api.

created_atstring date-time required

When the reaction was first set (UTC).

updated_atstring date-time required

When the reaction was last changed (UTC).