Notifications

List Notifications

GET /api/v1/notifications?limit=&cursor=&include_read= The caller's inbox, newest first, excluding dismissed and expired rows.

Cursor-paged rather than page/page_size (the convention elsewhere in this API) because this is the one prepend-heavy list we serve: producers insert at the top between a client's page 1 and page 2 requests, and offset paging would then re-show rows the user already scrolled past. The cursor is an opaque (created_at, id) pair — treat it as a token, not a number.

unread_count is returned on every page so the client can reconcile its badge without a second call.

get/api/v1/notifications

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/notifications
  • Auth: HTTP bearer

Query parameters

limitinteger
cursorstring nullable
include_readboolean

Response

Successful Response

next_cursorstring nullable
unread_countinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.