Sign in
Notifications

List the caller's notification inbox for one workspace, newest first

Changed on

Cookie session or Bearer PAT; no scope requirement — a personal read, not a workspace:admin operation. bunkai_list_notifications is SECURITY INVOKER — it runs under the caller's own RLS, so a foreign/inaccessible workspace id silently returns an empty page rather than leaking existence. Pagination is KEYSET on (created_at desc, id desc). unread_count is independent of pagination. An empty items is always a valid 200 — this endpoint never answers 404.

get/api/v1/workspaces/{id}/notifications

Request

  • Base URL: http://localhost:3000
  • URL: http://localhost:3000/api/v1/workspaces/{id}/notifications
  • Auth: one of:
    • API key in cookie sb-fmbpikzpkafptqximhxn-auth-token
    • HTTP bearer

Path parameters

idstring uuid required

Query parameters

limitinteger

Page size, 1..50 (default 30). Out of range is rejected (422); the RPC additionally clamps for direct callers.

cursorstring

Opaque page token taken verbatim from the previous response's next_cursor. A malformed token returns 400 — it never silently falls back to the first page.

Response

One page of the notification inbox (possibly empty).

unread_countinteger required

Count of unread notifications visible to the caller in this workspace — independent of pagination, NOT capped here (the UI applies the "99+" display cap, business-rules.md).

next_cursorstring nullable required

Opaque token for the next (older) page, or null when this is the last page. base64url — echo it back verbatim as ?cursor=; never construct or parse one.

Changes

  • 4528999528c6Revision changes
    • warning

      added the new test_outside_plan_project enum value to the / response property for the response status

    • warning

      added the new test_outside_plan_project enum value to the / response property for the response status

    • warning

      added the new test_outside_plan_project enum value to the / response property for the response status

  • 2ca74ff5fec5Revision changes
    • info

      removed the test_outside_plan_project enum value from the / response property for the response status

    • info

      removed the test_outside_plan_project enum value from the / response property for the response status

    • info

      removed the test_outside_plan_project enum value from the / response property for the response status