MINARA
リファレンス

HTTP API

ゲートウェイ（`npm run serve`）が公開するすべてのルート

HTTP ゲートウェイ（npm run serve）は、同一の Agent を REST/SSE API として提供します。すべてのルートはバージョンプレフィックス付きの /v1/... に配置されています。ただし、認証不要の /healthz 死活確認プローブを除きます。

認証

環境変数に GATEWAY_AUTH_TOKEN を設定すると、すべての /v1/... ルートで Bearer トークンが必須になります。未設定の場合、ゲートウェイはすべてのリクエストを受け入れます（ローカル開発専用）。

Authorization: Bearer <GATEWAY_AUTH_TOKEN>

ヘルスチェック

メソッドパス説明
GET/healthz死活確認プローブ。ゲートウェイが起動中であれば \{"ok": true\} とともに 200 を返します。
GET/v1/healthz/healthz のバージョン付きミラー。認証なしで \{"ok": true, "ts": ...\} を返します。

チャット

メソッドパス説明
POST/v1/chat/streamAgent ターンを開始し、セッション ID とともに即座に返します。ターンはバックグラウンドで実行されます。
POST/v1/assist/system-promptWeb UI ウィザードの「AI で生成」パス向けに、カスタム Agent のシステムプロンプトをストリーミングします。
POST/v1/chat/interjectセッションの実行中ターンに対して補足メッセージをキューに追加します。ゲートウェイが適切なタイミングで注入します。
POST/v1/chat/interruptセッションの実行中ターンを停止します。ターンは正常に終了し、途中までの作業は保持されます。
GET/v1/chat/recommendationセッション単位の機能推薦ストアをロングポーリングし、直近のターンで算出されたカードを返します。
GET/v1/chat/sessions/:id/goalセッションの継続ゴールを返します。設定がない場合は null を返します。
POST/v1/chat/sessions/:id/goalセッションに継続ゴールを設定します。すでにゴールがアクティブな場合は 400 で拒否されます。
POST/v1/chat/sessions/:id/goal/pause継続ゴールの自動継続を一時停止します。手動ターンは引き続き動作し、ゴールは再開できます。
POST/v1/chat/sessions/:id/goal/resume一時停止中のゴールを再開します。ターン残量をリセットし、ゴールが新たに動作できる状態にします。
POST/v1/chat/sessions/:id/goal/clear継続ゴールを削除します。不可逆な操作で、ゴールは完全に消去されます。
POST/v1/chat/sessions/:id/goal/subgoals継続ゴールに受諾条件を追加します。判定処理と次回ターンのプランナーが参照します。
DELETE/v1/chat/sessions/:id/goal/subgoals/:n位置 n（1 始まり）の受諾条件を削除します。該当位置が存在しない場合は 400 で拒否されます。

チャットセッション

メソッドパス説明
GET/v1/sessions/:parentId/subagent-runs/:childSessionId同期 subagent 委任 1 件の折りたたまれたトランスクリプトを返します。
GET/v1/sessionsユーザーのチャットセッション一覧を、最終アクティビティのタイムスタンプとメッセージ数付きで返します。
GET/v1/sessions/search全セッションのメッセージ内容を検索し、関連度順（SQLite FTS5、bm25）で返します。
POST/v1/sessions新しいセッション ID を発行します。Agent ループはセッション単位のステートをこの ID にスコープします。
GET/v1/sessions/:id主要な履歴読み取りエンドポイントです。セッションのメタデータと永続化されたすべてのメッセージを返します。
DELETE/v1/sessions/:idセッションとそのすべてのメッセージ、およびディスク上のワークスペースを削除します。
PATCH/v1/sessions/:idセッションのタイトルを設定します。手動での名前変更は、バックグラウンドの LLM 生成タイトルより優先されます。
GET/v1/institution/sessions/:sessionId/pipelineセッション固有のパイプライン、最新の実行スナップショット（フォールバック）、またはデフォルト設定を返します。
PUT/v1/institution/sessions/:sessionId/pipelineオプティミスティックなリビジョン管理を用いて、セッション固有のパイプラインを検証・保存します。
GET/v1/institution/sessions/:sessionId/runsラウンドテーブルの不変スナップショット、最終結果、レポートを時系列順で返します。

状態と制御

メソッドパス説明
GET/v1/statusキルスイッチの状態、当日の支出、ツール数、レビューエンジンの状態を返します。
GET/v1/system-metricsダッシュボードのシステムステータス行向けに、プロセスとシステムのスナップショット（CPU 使用率、メモリなど）を返します。
GET/v1/dashboard/achievementsWeb UI ダッシュボードバナー向けの統計情報（アクティベーションのタイムスタンプなど）を返します。
GET/v1/portfolioMinara バックエンドから現在のポートフォリオスナップショットを取得し、Agent が利用しやすい形式に整形して返します。
GET/v1/methodologies登録済みメソドロジーの一覧を、合格・不合格の件数と直近の結果付きで返します。
GET/v1/learning/audit/reportsメソドロジー監査ログのトレンドと履歴を返します。days（デフォルト 30）でフィルタリングできます。
GET/v1/learning/audit/reports/latest最新のメソドロジー監査レポート全体を返します。複合ヘルススコア、日次集計などを含みます。
GET/v1/learning/audit/reports/:passIdパス ID で検索した 1 件のメソドロジー監査レポートを全体で返します。
POST/v1/learning/audit/runオンデマンドで監査パスを 1 回実行し、永続化します。オプションのボディ \{ windowDays \} でウィンドウ幅を指定できます。
POST/v1/kill/v1/unkill が呼ばれるまで、ティア ≥ 2 のすべてのツール呼び出しをブロックします。緊急停止を想定した機能です。
POST/v1/unkillキルスイッチフラグをクリアします。
POST/v1/interactions/:id/answerターン中に Agent が投げかけた保留中の質問を解決します。質問は WS 経由で届きます。

ポートフォリオ

メソッドパス説明
GET/v1/portfolio/status簡易の準備状態プローブ。Minara が認証済みかどうか、どの取引所に到達可能かを返します。
GET/v1/portfolio/spot接続済みのすべてのウォレットにわたる現物残高を集計し、ゲートウェイの基準通貨に正規化して返します。
GET/v1/portfolio/spot/snapshot認証済みの Minara P&L リクエスト 1 回でステーブル資産残高と非ステーブル資産ポジションを取得し、初回表示時の重複リクエストを回避します。
GET/v1/portfolio/spot/positions平均取得コストが判明している場合はそれを含む、アセットごとの現物ポジションを返します。
GET/v1/portfolio/perpsMinara の全永続先物サブアカウントにわたるオープンポジションを返します。?subAccountId= でフィルタリング可能です。
GET/v1/portfolio/perps/summary全永続先物サブアカウントにわたる資産・マージン・未実現 PnL の集計値を返します。
GET/v1/portfolio/historyチャート表示用にバケット化された、ポートフォリオ総額の時系列データを返します。
GET/v1/portfolio/spot/activityユーザーのメインウォレットにおけるクロスチェーンの現物アクティビティ（スワップ・送金）フィードを返します。
GET/v1/tx/statusトランザクション ID を指定して、1 件のトランザクションのオンチェーンステータスをポーリングします。

永続先物

メソッドパス説明
GET/v1/perps/account-stateHyperliquid サブアカウント 1 件のライブ状態（資産・マージン使用率・出金可能額・オープン注文など）を返します。
GET/v1/perps/sub-accountsユーザーの Minara 永続先物ウォレット配下のすべてのサブウォレットを、マルチ取引所情報付きで返します。
GET/v1/perp-wallets/v1/perps/sub-accounts と同じハンドラです。上流の OpenAPI パスに合わせたエイリアスです。
POST/v1/perp-wallets1 つの取引所（hyperliquid または lighter）に紐づく新しい永続先物サブアカウントを作成します。
POST/v1/perps/sub-accountsPOST /v1/perp-wallets の Agent ネイティブエイリアスです。ボディとレスポンスの形式は同一です。
POST/v1/perp-wallets/rename既存の永続先物サブアカウントの名前を変更します。ボディ: \{ subAccountId: string, name: string \}。
POST/v1/perps/sub-accounts/renamePOST /v1/perp-wallets/rename の Agent ネイティブエイリアスです。
POST/v1/trading-gateway/place-ordersサブアカウントに紐づく取引所に対して、永続先物の注文を一括発注します。
POST/v1/trading-gateway/cancel-orders\{ symbol, orderId \} のセットで注文を一括キャンセルします。ボディ: \{ cancels: \{ symbol: string, order... \} \}。
POST/v1/trading-gateway/modify-orderアクティブな注文の価格・数量・トリガー価格を変更します。ボディ: \{ symbol: str... \}。
POST/v1/trading-gateway/update-leverageシンボルのレバレッジとマージンモード（クロス / アイソレーテッド）を 1 回のラウンドトリップで変更します。
POST/v1/trading-gateway/update-isolated-margin既存ポジションのアイソレーテッドマージン額を調整します。ボディ: \{ symbol: stri... \}。
POST/v1/trading-gateway/withdrawUSDC を外部アドレスに出金します。ボディ: \{ amount: string, toAddress: string... \}。
GET/v1/trading-gateway/summary1 つのサブウォレットの資産・オープンポジション・オープン注文を一括で取得します。
GET/v1/wallet/deposits現物と永続先物の入金アドレスをまとめた 1 つのエンベロープを返します。
GET/v1/wallet/supported-chains上流 Minara の /tokens/supported-chains エンドポイントのプロキシです。対応チェーンの一覧を返します。
POST/v1/wallet/withdraw/spotクロスチェーン現物出金をプレビュー（confirm: false）または実行（confirm: true）します。
POST/v1/wallet/withdraw/perps永続先物の USDC/Arbitrum 出金をプレビュー（confirm: false）または実行（confirm: true）します。
GET/v1/wallet/withdrawals/{operationId}出金オペレーションの永続的なステータスを検索します。最新の既知のステータスを返します。
GET/v1/perps/trades1 つのサブウォレットの Hyperliquid 約定履歴をライブで返します（ローカルミラーは使用しません）。
GET/v1/perps/funding永続先物ポジションごとに受け取り・支払いの資金調達率を返します。
GET/v1/perps/transfersウォレット単位の Hyperliquid 入金、出金、口座振替履歴を返します。
GET/v1/perps/order-history最近約定・キャンセルされた注文を返します。
GET/v1/perps/lighter-pnlLighter サブウォレットの累計実現 PnL を、Lighter のファーストクラス API から取得して返します。
GET/v1/ordersパーペチュアル注文、または source=spot で現物条件注文を返します。
POST/v1/perps/transfer遊休 USDC を 1 つの永続先物サブウォレットから別のサブウォレットへ移動します。USDC 専用です。資金移動のため、プレビューが先行します。
GET/v1/perps/sub-account/:subAccountId/idle-usdc永続先物サブウォレットの「移動可能な」USDC 残高（必要マージン差し引き後）を単一の数値で返します。

Autopilot

メソッドパス説明
GET/v1/autopilot/managed/catalogピッカーが提供できるマネージド戦略タイプ（Sharpe ガイドなど）の一覧を返します。
GET/v1/autopilot/managed/catalog/:strategyType/backtest1 つのマネージド戦略タイプのバックテストプレビュー（資産曲線とヘッドライン統計）を返します。
GET/v1/autopilot/managed/strategiesバインドされたサブアカウントと正規化済みステータスを含む、すべてのマネージド戦略を返します。
GET/v1/autopilot/managed/aggregated-summaryAutopilot KPI バーとダッシュボードのマネージド戦略セクションが共有する集計ソースを返します。
GET/v1/autopilot/managed/xstrategy/deploymentsユーザーのライブ XStrategy デプロイ（全ステータス）を一覧表示します。
GET/v1/autopilot/managed/xstrategy/backtest/:backtestIdデプロイのマルチアセットバックテストレポート全体を返します（/curves を追加すると資産曲線も取得できます）。
GET/v1/autopilot/managed/by-sub-account/:subAccountId詳細パネルが利用するサブアカウント単位のスナップショット（紐づいた戦略、または null）を返します。
POST/v1/autopilot/managed/strategiesサブウォレットにマネージド戦略を作成します。資金移動のため、confirm を省略（または false）すると プレビューが返ります。
POST/v1/autopilot/managed/run別ソースの戦略を Autopilot として実行します。marketplace はパブリック戦略をサブスクライブします。
POST/v1/autopilot/managed/:strategyId/disable実行中のマネージド戦略を停止します。資金に影響するため、同じプレビュー → 確認フローに従います。
POST/v1/autopilot/managed/xstrategy/:strategyId/stopユーザーが作成したライブ XStrategy デプロイを停止します。Autopilot のインターフェース上に表示されます。
POST/v1/autopilot/managed/xstrategy/:strategyId/deploy既存のデプロイをクローンして、選択したサブウォレットに XStrategy をデプロイします。

市場データ

メソッドパス説明
GET/v1/quote/batch複数ティッカーの現物・永続先物の気配値を 1 回のラウンドトリップで返します。ティッカーボードが使用します。
GET/v1/quote/:ticker現物価格・24 時間変動率・伝統的指標（P/E、EPS、配当利回り、52 週高安値）を返します。
GET/v1/quote/crypto/:symbol1 つの暗号資産の時価総額・FDV・24 時間出来高（USD）・24 時間変動率・名称・ロゴ・チェーンを返します。
GET/v1/market/candles1 つのティッカーと時間足の OHLC バーを返します。適切なプロバイダー（Hyperliquid など）にルーティングされます。
GET/v1/market/perps-priceHyperliquid または Lighter の永続先物市場の現在価格と、取引所固有の市場識別子を返します。
GET/v1/market/sparklineWeb UI のインラインスパークライン描画用に、終値のみのコンパクトな時系列データを返します。
GET/v1/market/trendingWorkbench の資産スイッチャー向けに正規化されたトレンド暗号資産と株式の項目を返します。
GET/v1/market/search暗号資産・株式・ETF・コモディティ・外国為替にわたってティッカーシンボルと名称をファジー検索します。
GET/v1/markets/moversマーケット概要ボード向けの大幅変動銘柄を返します。class=stocks（デフォルト）で株式を返します。
GET/v1/markets/snapshotマーケット概要ボードのマクロデータを 1 回の呼び出しでまとめて返します（主要指数の気配値など）。
GET/v1/markets/sectorsボードのヒートマップ向けに、11 の GICS セクターの日次パフォーマンスを返します。
GET/v1/markets/newsYahoo Finance のキーレス RSS から解析した市場ヘッドラインフィードを返します。
GET/v1/markets/calendarNasdaq のキーレスカレンダーから、次回セッションの決算発表を取得して返します。

音声

メソッドパス説明
GET/v1/voice/status音声サービスの設定状態を返します。stt_configured（文字起こしプロバイダー）を含みます。
GET/v1/voice/voices音声ピッカーの選択肢一覧を返します。公式プリセット音声（ElevenLabs・OpenAI）を常に含みます。
GET/v1/voice/settings現在のユーザー設定可能な音声合成設定を返します。provider=openai で OpenAI の音声設定を取得できます。
PUT/v1/voice/settingsユーザーが調整した音声合成設定を永続化します。provider=openai または provider=... を指定します。
POST/v1/voice/cleanupチャットメッセージに紐づく永続化された音声（返答音声・マイク録音）を削除します。
POST/v1/voice/transcribeアップロードされた音声録音を、設定済みの音声プロバイダー（ElevenLabs など）で文字起こしします。
POST/v1/voice/tts最大 4096 文字のテキストを音声合成してストリーミングします。プロバイダーのボディはパイプ処理されます。
POST/v1/sessions/:id/voice-audio事前にアップロードした音声ファイル（POST /v1/files）をアシスタントメッセージに添付します。

画像・動画

メソッドパス説明
GET/v1/media/settingsFal.ai の接続状態と、個別に選択された画像・動画エンドポイントを返します。
PUT/v1/media/settingsFal.ai の認証方式、またはデフォルトの画像・動画エンドポイントを選択します。
GET/v1/media/models1 つの出力モダリティに対するアクティブな Fal.ai エンドポイントの一覧を返します。
POST/v1/media/models/refresh1 つまたは両方の出力モダリティのカタログキャッシュ（5 分）をバイパスします。
GET/v1/media/models/schema解決済みの OpenAPI 入出力スキーマ・フィールド順・推論メタデータを返します。
POST/v1/media/providers/fal/oauth/initFal.ai のデバイスフローを開始し、ユーザーコードと確認 URL を返します。
GET/v1/media/providers/fal/oauth/pollデバイスフローをポーリングします。成功すると、更新可能な OAuth 資格情報を保存します。
POST/v1/media/providers/fal/api-keyFal.ai の API キーを検証して資格情報ストアに保存し、その後の処理を続行します。
DELETE/v1/media/providers/fal/auth/:kind保存済みの Fal.ai サインインプロファイルまたは API キーオーバーライドを削除します。

ファイルとアーティファクト

メソッドパス説明
POST/v1/filesサンドボックス化されたワークスペースにファイルをアップロードします。後で参照できるキーを返します。
GET/v1/files/:key以前アップロードしたサンドボックスファイルをストリーミングで返します。
GET/v1/artifacts/:idAgent が生成したアーティファクト（チャート・スプレッドシート・レポートペイロード）を ID で取得します。
GET/v1/artifactsWeb UI のファイルページ向けに、完成済みのレポートアーティファクト一覧を返します。kind=ch... でフィルタリング可能です。
DELETE/v1/artifactsアーカイブ済みのレポートアーティファクトとそのファイルを 1 件から最大 200 件まで完全削除します。
GET/v1/sandbox/files/:nameAgent がセッション単位のサンドボックスに書き込んだファイルを読み取ります。サンドボックス外への脱出はできません。

ワークスペースファイル

メソッドパス説明
GET/v1/workspace/files編集可能なすべてのワークスペース md ファイルを、サイズ・mtime・sha256 付きで列挙します。
GET/v1/workspace/files/:name1 つのワークスペース md ファイルの内容と sha256 を返します。:name はファイル名と一致する必要があります。
PUT/v1/workspace/files/:nameワークスペース md ファイルをアトミックに置き換えます。expected_sha256 は必須です。
POST/v1/workspace/files/:name/restore-templatesrc/workspace/templ... に同梱されたテンプレートでワークスペースファイルを上書きします。

リサーチ

メソッドパス説明
POST/v1/researchチャットを経由せず、ゲートウェイから直接ディープリサーチパイプラインを実行します。
GET/v1/institution/skills環境で利用可能なスキルと、ラウンドテーブルで使用可能な読み取り専用ツールを一覧表示します。
GET/v1/institution/agent-templatesラウンドテーブル Agent を設定するための、組み込みおよびユーザー作成テンプレートを一覧表示します。
POST/v1/institution/agent-templates独立した再利用可能な Agent 設定を保存します。
PATCH/v1/institution/agent-templates/:templateIdユーザー作成の Agent テンプレートを更新します。組み込みテンプレートは変更できません。
DELETE/v1/institution/agent-templates/:templateIdユーザー作成の Agent テンプレートを削除します。既存のラウンドテーブルのコピーには影響しません。
GET/v1/institution/roundtable-templatesデフォルトおよびユーザー作成のラウンドテーブルテンプレート全体を一覧表示します。
POST/v1/institution/roundtable-templatesタイトル・説明・フェーズ・Agent 設定を自己完結した形で保存します。
PATCH/v1/institution/roundtable-templates/:templateIdユーザー作成のラウンドテーブルのタイトル・説明・設定を更新します。
DELETE/v1/institution/roundtable-templates/:templateIdユーザー作成のテンプレートを削除します。既存のセッションや実行スナップショットには影響しません。
GET/v1/institution/runs/:runId/snapshot不変のテンプレート・パイプライン・Agent 設定・使用状況・最終結果を返します。

パーソナライゼーションとメモリ

メソッドパス説明
GET/v1/profileAgent がすべてのシステムプロンプトに注入するパーソナライゼーションスナップショットを返します。
GET/v1/profile/onboardingユーザーがオンボーディングを完了したかどうかと、保存済みの回答の生データを返します。
POST/v1/profile/onboardingオンボーディングの回答を適用します。金融知識・頻度・リスク・市場の設定をプロファイルにマッピングします。
GET/v1/financial-profile最新の永続化された financial_profile 行（プラットフォームウォレットのサマリーなど）を返します。
PUT/v1/profile/promptユーザーのカスタムシステムプロンプト追記（最大 2000 文字）を置き換えます。
DELETE/v1/profile/prompt追記を削除します。UI は呼び出し前にハード確認を表示します。
PUT/v1/profile/tags/:name11 種類の行動タグディメンション（例: risk、markets）の 1 つを設定またはクリアします。
DELETE/v1/profile/tags/:namevalue: null での PUT と同等です。タグがクリアされ、Agent が次回ターンで再推定します。
GET/v1/memorycategory でフィルタリングした直近のメモリを返します。またはハイブリッド検索（BM25 + ベクター）を実行します。
GET/v1/memory/trading-casescategory = 'trading-cases' のメモリテーブルから自由形式のノートを返します（レガシー）。
GET/v1/memory/research-cases/research の実行結果から topic でフィルタリングしたメモリを返します。リサーチの振り返りが使用します。
POST/v1/memoryAgent が常に記憶すべきメモリを手動で書き込みます。サーバーは category=personal のスタンプを押します。
PATCH/v1/memory/:idsource=user_manual のメモリの statement・fact_type・tickers を編集します。
DELETE/v1/memory/:iddeleted_at = now() を設定します。読み取りパス（FTS・一覧・スナップショット）はこの行をフィルタリングします。
POST/v1/memory/:id/restoredeleted_at をクリアします。Web UI の取り消しトースト（5 秒間）に連動していますが、単独でも動作します。
POST/v1/profile/refresh3 つのパーソナライゼーション再構築（trading_summary / tags / memories）をすべて実行します。
GET/v1/profile/trade-history-breakdownフィナンシャルプロファイルダッシュボードに表示する 3 ソース別の取引履歴内訳を返します。
GET/v1/profile/reference-walletsユーザーの外部ウォレットアドレスのウォッチリストを返します。
PUT/v1/profile/reference-walletsウォッチリストをアトミックに置き換えます。EVM（0x + 40 桁の 16 進数）と Solana の形式を検証します。

学習済み嗜好

メソッドパス説明
GET/v1/learned-preferences確認待ちの推定行動嗜好（提案 / アクティブ / 非推奨）を返します。
POST/v1/learned-preferences/:id/:action1 つの学習済み嗜好のステートを遷移させます。承認するとアクティブになり、システムプロンプトに反映されます。
GET/v1/learned-preferences/:id1 つの学習済み嗜好 ID の完全レコード（説明・シグナル強度・履歴）を返します。
GET/v1/watchlistプロファイルに永続化されたユーザー設定のシンボルウォッチリストを返します。
PUT/v1/watchlistウォッチリストを置き換えます（最大 100 シンボル）。
GET/v1/runtime-preferencesサブ機能のトグルスキーマ・現在のオーバーライド・解決済みの値を返します。
PUT/v1/runtime-preferencesユーザーオーバーライドを一括適用します。検証はすべて成功するか、すべて失敗するかのどちらかです。If-Match をサポートします。
GET/v1/runtime-preferences/critical-unlock-statusクリティカルティアのトグルが現在アンロックされているかどうかを返します（CLI の minara c... 経由）。
POST/v1/runtime-preferences/critical-unlock短命のアンロックを発行し、続く PUT /v1/runtime-preferences でクリティカルトグルを変更できるようにします。
POST/v1/runtime-preferences/sign-ack次の PUT /v1/runtime-preferences で使用される短命の署名済み ack トークンを発行します。
GET/v1/credentials/familiesプロバイダーファミリーのレジストリ（ウェブ検索・市場データ・エンベディング・クラウドなど）を返します。
PUT/v1/credentials/families/:id1 つのプロバイダーファミリーのオーバーライドを ~/... の dataSources スロットに書き込みます。
DELETE/v1/credentials/families/:id/field/:envVar1 つのフィールドのオーバーライドを削除します（環境変数由来のフォールバックに戻します）。
GET/v1/credentials/secretsフラットな資格情報スロットにわたって設定済みのすべての資格情報キーを返します。
PUT/v1/credentials/secrets/:keyUPPER_SNAKE キーで値を保存します。メッセージング用の環境変数はメッセージングサービスにルーティングされます。
GET/v1/credentials/custom~/.minara/credentials.json のフリーフォーム custom スロットにあるすべてのキーを返します。
PUT/v1/credentials/custom/:keycustom スロットの任意のフリーフォームキーに値を保存します（アトミック・ファイルロック付き）。
DELETE/v1/credentials/custom/:keycustom スロットから 1 つのキーを削除します。

通知

メソッドパス説明
GET/v1/notifications最近のアプリ内通知（新しい順）と unread_count を返します。
DELETE/v1/notificationsすべての通知を削除します。\{ ok, cleared \} を返します。
POST/v1/notifications/read-allすべての未読通知を既読にします。\{ ok, updated \} を返します。
POST/v1/notifications/:id/read1 件の通知を既読にします（冪等）。\{ ok: true, updated \} を返します。
DELETE/v1/notifications/:idID を指定して 1 件の通知を削除します。

学習とメソドロジー

メソッドパス説明
GET/v1/memory/trading-cases/statsトレーディングケースダッシュボード向けの 4 つの数値スナップショット（総件数・直近 30 日・勝率など）を返します。
GET/v1/memory/trading-cases/methodology-trend上位 N 件のメソドロジーの outcome_alpha_return を週次時系列で返します。
GET/v1/memory/methodologiesWilson 信頼度下限でランク付けされた上位 N 件のメソドロジーを、件数・資産クラス付きで返します。
GET/v1/memory/methodology-cases統合された methodology_observations 台帳を読み取ります。監査台帳の描画に使用されます。
GET/v1/memory/trading-cases/:idmethodology_observations.id 1 件の完全な行 JSON を返します。右側のドロワーが使用します。
GET/v1/memory/trades統合された trade_executions から、Agent が実行した最近の取引（アクション・送受金情報など）を返します。
GET/v1/memory/strategy-runsstrategy_runs からユーザーの Autopilot・マネージド戦略の実行履歴（名称・作成者など）を返します。
GET/v1/memory/factsfact_type（observation.* / preference.* / goal.target など）でフィルタリングした FactLayer の行を返します。

スキル

メソッドパス説明
GET/v1/skillsAgent がアクティベートできる、登録済みのすべてのドメインスキルを返します。アクティベーション情報を含みます。
POST/v1/skills/reloadベンダー化された外部スキルパッケージをサンドボックスに再ミラーリングし、再登録します。

統計

メソッドパス説明
GET/v1/statsチャットセッション別にバケット化された、token・コスト・ツール呼び出しのカウンターを返します。
POST/v1/telemetry/block-actionui_block イベント（UBP v1）のクリック記録をファイアアンドフォーゲットで送信します。Web UI が使用します。

LLM プロバイダー

メソッドパス説明
GET/v1/llm/default-modelAgent ループが新しいターンで現在使用しているモデル ID を返します。
PUT/v1/llm/default-modelAgent ループを別のモデル ID に切り替えます。利用可能なモデルの一覧に対して検証されます。
GET/v1/llm/available-modelsゲートウェイがディスパッチできるモデルをプロバイダーごとにグループ化して返します。
POST/v1/llm/available-models/refreshインメモリキャッシュをバイパスして、アクティブなプロバイダーのモデルカタログを強制的に再取得します。
GET/v1/llm/background-modelsバックグラウンド作業モデルの対応状況、有効状態、設定元、指定スロット、およびチャット・タイトル・圧縮・無人作業・視覚に使うモデルを返します。
PUT/v1/llm/background-modelsバックグラウンド作業モデルのオン／オフと、タイトル・圧縮・無人作業用モデルを更新します。enabled: null で環境または組み込み既定値に戻します。
GET/v1/shortcut-questions手動作成の固定リストと、カテゴリごとに LLM が生成した動的な質問を返します。

テーマ

メソッドパス説明
GET/v1/themeWeb UI のテーマ設定（ライト / ダーク / システム + アクセントカラー）を返します。
POST/v1/theme永続化されたテーマ設定を更新します。
GET/v1/settings/report-design機関投資家モードとディープリサーチの HTML レポートが使用する永続化済みのビジュアル設定を返します。
PUT/v1/settings/report-design機関投資家モードとディープリサーチが使用するビジュアル設定を正規化して永続化します。
GET/v1/report-style機関投資家モードとディープリサーチが共有する完全なレポートスタイル設定を返します。
PUT/v1/report-styleレポートのデザイン設定やカスタム REPORT.css を 1 回のリクエストで更新します。
PUT/v1/report-style/preset組み込みのレポートスタイルプリセットを 1 つ適用し、残りの設定は保持します。
PUT/v1/report-style/css選択したプリセットの後に適用されるカスタム REPORT.css を検証して置き換えます。

ゲートウェイ

メソッドパス説明
GET/v1/gateway/providersゲートウェイに登録されたインバウンドメッセージングプロバイダー（Slack、Lark など）を返します。
POST/v1/gateway/providers/:id/fields/:envVar/revealマスクされた資格情報フィールド 1 件（例: TELEGRAM_B...）の平文を返します。
POST/v1/gateway/providers/:id/resolve-chat-idgateway が保持しているトークンを使ってボットの送信先チャットIDを解決します。呼び出し側はトークンに触れません。ポーリング式: found / awaiting_start / conflict / invalid_token。
POST/v1/gateway/providers/:id/oauth/initOAuth 方式のメッセージングプロバイダー（email-...）に対して Google OAuth の同意フローを開始します。
GET/studio/p/:pageId生成されたデータスタジオダッシュボードを、独自のリンクを持つスタンドアロン HTML ページとして提供します。

マイグレーション

メソッドパス説明
GET/v1/migrate/manifestエクスポート可能なデータセット（メモリ・プロファイル・設定・ワークフロー）の一覧を返します。
POST/v1/migrate/export指定したマニフェストエントリをポータブルな JSON ブロブにまとめて、バックアップや移行に使用できます。
POST/v1/migrate/importエクスポート済みのバンドルから復元します。安定した ID（メモリ・プロファイルなど）に対して冪等です。

管理

メソッドパス説明
GET/v1/admin/script-risk/decisionsexecute_code / term... の前にあるスクリプトリスクゲートの決定の監査ログを返します。
GET/v1/admin/script-risk/decisions/:idスクリプトリスクゲートの決定 1 件の完全な監査レコードを返します。
GET/v1/consent/grantsCron / ワークフローから実行されるティア 3 / ティア 4 ツールの、オーサリング時の同意許可を一覧表示します。
POST/v1/consent/grants自律的に実行予定のティア 3 / ティア 4 ツール呼び出しに対するオペレーターの承認を記録します。
GET/v1/consent/grants/:id1 件の同意許可の完全レコードを返します。
DELETE/v1/consent/grants/:id許可を失効済みとしてマークします。同じスコープでのその後の自律的ツール呼び出しはブロックされます。
POST/v1/consent/grants/requirements下書きの Cron / ワークフロー / Agent 定義をドライランでスキャンし、ティア 3 / ティア 4 ツールを検出します。

設定

メソッドパス説明
GET/v1/config/financial-profileデバッグ用エンドポイントです。現在読み込まれている有効な FinancialProfileConfig を返します。
GET/v1/config/financial-profile現在解決済みの FinancialProfileConfig を返します。再構築のデバッグに役立ちます。

認証

メソッドパス説明
POST[`

yahoo_finance

共有のライブ株式フォールバックデータ。FMP から正規化された価格、日次履歴、企業概要を優先取得し、失敗時は Yahoo Finance にフォールバックします。

単一のスクリプトリスク判断を取得

GET /v1/admin/script-risk/decisions/:id：単一のスクリプトリスクゲート判断の完全な監査記録です。

目次

認証ヘルスチェックチャットチャットセッション状態と制御ポートフォリオ永続先物Autopilot市場データ音声画像・動画ファイルとアーティファクトワークスペースファイルリサーチパーソナライゼーションとメモリ学習済み嗜好通知学習とメソドロジースキル統計LLM プロバイダーテーマゲートウェイマイグレーション管理設定認証