---
title: "Set Signal Reaction"
method: PUT
path: "/{brand_id}/signals/{signal_id}/reaction"
tags: ["signals"]
---

# Set Signal Reaction

`PUT /{brand_id}/signals/{signal_id}/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.

## Path parameters

- `brand_id` integer, required
- `signal_id` integer, required

## Request body

- APISignalReactionUpsert — Request body for `setSignalReaction`.
  - `reaction` 'useful' | 'not_useful' | 'dismissed' | 'actioned', required — Reaction to set: `useful`, `not_useful`, `dismissed`, or `actioned`.
  - `reason` string, nullable — Optional free-text reason accompanying the reaction.

## Response `200`

Successful Response

- APISignalReaction — A user's reaction to a signal's stable identity.
  - `user_id` integer, required — ID of the user the reaction belongs to.
  - `insight_id` integer, required — Signal ID the reaction was last set on.
  - `fingerprint` string, required — Stable signal identity the reaction follows across re-detections.
  - `reaction` 'useful' | 'not_useful' | 'dismissed' | 'actioned', required — The reaction value.
  - `reason` string, 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_at` string, date-time, required — When the reaction was first set (UTC).
  - `updated_at` string, date-time, required — When the reaction was last changed (UTC).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrunchai/apis/scrunch-data-api.md) · [All operations](https://skmtc.net/scrunchai/apis/scrunch-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrunchai/scrunch-data-api/revisions/c4fe20c603a3/schema)