#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

Query parameters

Name	Type	Description
limit	integer	Maximum notifications to return
unread	boolean	Only unread notifications
cursor	string	Keyset cursor from the previous page

Responses

Status	Description	Schema
200	OK	NotificationPage
401	Unauthorized	Error
403	Forbidden	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	OK	NotificationRead
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#POST /notifications/read-all

Mark all notifications read

Auth: Bearer token required

Responses

Status	Description	Schema
200	OK	NotificationReadAll
401	Unauthorized	Error
403	Forbidden	Error

#Schemas

#Error

Field	Type	Description
error	string	(required)
code	string

#NotificationPage

Field	Type	Description
items	object[]	(required)
nextCursor	string | null	Cursor for the next page; null on the final page (required)
unreadCount	integer	(required)

#NotificationRead

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

#NotificationReadAll

Field	Type	Description
updated	integer	(required)