通知を一覧表示

GET /v1/notifications

新しい順のアプリ内通知と unread_count を取得します。カスタムエージェントが自ら起動し（スケジュール、イベント、または 1 回限り）、そのアプリ内設定で結果の受信を選んだときに通知が記録されます。任意の ?limit= のデフォルトは 50、最大値は 200 です。

デスクトップでは、ローカルのセッションイベントとログイン中のアカウントのサーバー通知も含まれます。server_owner はアカウント範囲を表す不透明な識別子で、ログアウト中は null、デスクトップ受信機能が無効な場合は省略されます。サーバーのレコードは source: server を持ち、tag を含む場合があります。タイトルと本文はサーバーが生成します。Accept-Language と X-Minara-Client-Version は、このインストールの購読情報のみを更新します。サーバー通知の既読・削除操作は現在のアカウントにのみ適用され、一覧を消去しても配信の重複排除記録は保持されます。サーバー受信箱が変わると notifications WebSocket チャネルから data が空のオブジェクトの notifications_changed が送信されます。この API を再取得して同期してください。

PC の presentation は system（false、always、unfocused-only）、inbox（真偽値）、toast（false、focused-only）を個別に指定します。未読件数に含まれるのは inbox のレコードのみです。server_deliveries には今回の gateway 起動後に受信したリアルタイム通知が含まれ、ベルに入らないものもあります。historical の履歴やコールドスタート時の受信箱からシステム通知や Toast を再表示しません。未知の内部パスはホームに戻ります。通常の Chat/Coding 完了と入力待ちは、フォーカスが外れているときだけシステム通知を表示します。