#Notifications

---

#GET /notifications

List the current user's notifications

User-scoped; the row's user_id is the only access boundary. Supports ?unread=true and ?limit.

Auth: Bearer token required

Responses

Status	Description	Schema
200	Notifications + unread count	NotificationList
401	No user session	Error

---

#POST /notifications/{id}/read

Mark a notification read

Auth: Bearer token required

Path parameters

Name	Type	Description
id	string

Responses

Status	Description	Schema
200	Marked read	NotificationRead
401	No user session	Error
404	Notification not found	Error

---

#POST /notifications/read-all

Mark all notifications read

Auth: Bearer token required

Responses

Status	Description	Schema
200	Count of notifications marked read	NotificationReadAll
401	No user session	Error

#Schemas

#Error

Field	Type	Description
error	string	(required)
code	string

#NotificationList

Field	Type	Description
items	object[]	(required)
unreadCount	integer	(required)

#NotificationRead

Field	Type	Description
id	string(uuid)	(required)
readAt	string	(required)

#NotificationReadAll

Field	Type	Description
updated	integer	(required)