My unread badge count

GET

/account/notifications/unread-count

• Local development behind nginx (port 8088 by default)

The hot read behind the navbar bell on every authenticated page render. Backed by a partial index (WHERE read_at IS NULL) so the working set stays bounded even as the lifetime notifications table grows. Per-user cached via cache.Registry — invalidates on every write to this user’s rows.

Authorizations

• cookieAuth
• bearerAuth

Responses

200

Unread count snapshot.

object

count

required

integer format: int64

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}