---
title: "Respond To Notification"
method: POST
path: "/notifications/{notification_id}/response"
tags: ["users"]
---

# Respond To Notification

`POST /notifications/{notification_id}/response`

Receive a user's response to an interactive push notification.

Accepts button taps (action=button_1/2/3) or text replies (action=reply).
The response is treated as board feedback: it gets persisted as a
BoardMessage and triggers a board regeneration so the coach can react.

## Path parameters

- `notification_id` string, required

## Query parameters

- `user_id` string, nullable

## Request body

- NotificationResponseRequest — Request schema for responding to an interactive notification.
  - `action` string, required — Action identifier: 'reply' for text input, or 'button_1'/'button_2'/'button_3' for button taps.
  - `label` string, nullable — The button label that was tapped (null for text replies).
  - `text` string, nullable — User's text reply (null for button taps).

## Response `200`

Successful Response

- NotificationResponseResponse — Response schema after storing a notification response.
  - `id` string, required
  - `notification_id` string, required
  - `action` string, required
  - `acknowledged` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/imperfect/apis/imperfect-api.md) · [All operations](https://skmtc.dev/imperfect/apis/imperfect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imperfect/imperfect-api/revisions/cc2293a44257/schema)