MINARA
參考

HTTP API

網關（`npm run serve`）暴露的所有路由

HTTP 網關（npm run serve）通過 REST/SSE API 暴露同一個 Agent。所有路由都帶有版本前綴 /v1/...，未鑑權的 /healthz 存活探針除外。

鑑權

在環境變量中設置 GATEWAY_AUTH_TOKEN，即可要求所有 /v1/... 路由攜帶 bearer token。若未設置，網關接受所有請求（僅限本地開發環境使用）。

Authorization: Bearer <GATEWAY_AUTH_TOKEN>

健康檢查

方法路徑描述
GET/healthz存活探針。網關正常時返回 200 及 \{"ok": true\}。
GET/v1/healthz/healthz 的版本化鏡像。無需鑑權，返回 \{"ok": true, "ts": ...\}。

對話

方法路徑描述
POST/v1/chat/stream啟動一個 Agent 輪次並立即返回 session id。輪次在後臺運行……
POST/v1/assist/system-prompt為 Web UI 嚮導的"AI 生成"入口流式輸出自定義 Agent 系統提示詞……
POST/v1/chat/interject將引導消息加入當前會話正在執行的輪次隊列。網關會將其注入……
POST/v1/chat/interrupt停止當前會話正在執行的輪次。輪次會優雅結束，已完成的工作得以保留……
GET/v1/chat/recommendation長輪詢每個會話的功能推薦存儲，獲取最近計算的卡片……
GET/v1/chat/sessions/:id/goal返回會話的持續目標；未設置時返回 null。Agent 會持續追蹤該目標……
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 委派的摺疊轉錄記錄。子……
GET/v1/sessions列出用戶的對話會話，包含最後活躍時間戳和消息數量，按最近排序……
GET/v1/sessions/search在所有會話中搜索消息內容，按最佳匹配排序（SQLite FTS5，bm25……）。
POST/v1/sessions創建新的 session id；Agent 循環將按會話範圍管理狀態（凍結快照……）。
GET/v1/sessions/:id主要歷史讀取端點：會話元數據及所有已持久化的消息……
DELETE/v1/sessions/:id刪除會話及其所有消息（以及會話的磁盤工作區）……
PATCH/v1/sessions/:id設置會話標題。手動重命名優先於後臺 LLM 生成的標題……
GET/v1/institution/sessions/:sessionId/pipeline返回會話專屬 pipeline、最新運行快照（回退）或默認值……
PUT/v1/institution/sessions/:sessionId/pipeline使用樂觀版本控制驗證並保存會話專屬 pipeline。
GET/v1/institution/sessions/:sessionId/runs按時間順序返回不可變的圓桌研判快照、最終結果和報告……

狀態與控制

方法路徑描述
GET/v1/status緊急停止開關狀態、當日支出、工具數量、審核引擎狀態，等同於……
GET/v1/system-metrics進程與系統快照，用於儀表盤系統狀態行：CPU 佔用率、內存……
GET/v1/dashboard/achievementsWeb UI 儀表盤橫幅的統計數據：激活時間戳、已發現……
GET/v1/portfolio來自 Minara 後端的當前投資組合快照，已格式化供 Agent 使用……
GET/v1/methodologies已註冊方法論列表，包含通過/失敗次數及近期結果……
GET/v1/learning/audit/reports方法論審計健康報告的趨勢與歷史。可用 days 參數查詢（默認 30）……
GET/v1/learning/audit/reports/latest最新的完整方法論審計報告：綜合健康評分、每日……
GET/v1/learning/audit/reports/:passId按 pass id 查找的完整方法論審計報告。
POST/v1/learning/audit/run按需運行一次審計並持久化。可選 body \{ windowDays \}（清……）。
POST/v1/kill阻斷所有等級 ≥ 2 的工具調用，直到調用 /v1/unkill。用於緊急……
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 盈虧請求取得穩定幣餘額和非穩定幣倉位，避免首次載入時重複請求上游。
GET/v1/portfolio/spot/positions各資產現貨倉位，包含已知的平均成本基礎。
GET/v1/portfolio/perps所有 Minara 永續合約子賬戶的未平倉倉位。可用 ?subAccountId= 篩選……
GET/v1/portfolio/perps/summary跨永續合約子賬戶的彙總權益 / 保證金 / 未實現盈虧。
GET/v1/portfolio/history按圖表顯示分桶的總投資組合價值時間序列。
GET/v1/portfolio/spot/activity用戶主錢包的跨鏈現貨活動流（閃兌 + 轉賬）……
GET/v1/tx/status按交易 id 輪詢單筆交易的鏈上狀態。封裝 Minara……

永續合約

方法路徑描述
GET/v1/perps/account-state某個 Hyperliquid 子賬戶的實時狀態：權益、保證金使用量、可提現金額、未結訂單……
GET/v1/perps/sub-accounts用戶 Minara 永續合約錢包下的所有子錢包，附多交易所……
GET/v1/perp-wallets與 /v1/perps/sub-accounts 相同的處理函數；與上游 OpenAPI 路徑對齊……
POST/v1/perp-wallets創建一個綁定到某個交易所（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一次 round-trip 內更改某標的的槓桿倍數和保證金模式（全倉 vs 逐倉）……
POST/v1/trading-gateway/update-isolated-margin調整已有倉位的逐倉保證金金額。請求體：\{ symbol: stri……
POST/v1/trading-gateway/withdraw將 USDC 提現到外部地址。請求體：\{ amount: string, toAddress: string……
GET/v1/trading-gateway/summary單次讀取某個子錢包的權益、未平倉倉位和未結訂單……
GET/v1/wallet/deposits包含現貨和永續合約充值地址的統一信封。現貨從用戶的跨……映射。
GET/v1/wallet/supported-chains代理上游 Minara /tokens/supported-chains 端點。返回……列表。
POST/v1/wallet/withdraw/spot預覽跨鏈現貨提現（confirm: false）或執行（confirm: ……）。
POST/v1/wallet/withdraw/perps預覽永續合約 USDC/Arbitrum 提現（confirm: false）或執行（confir……）。
GET/v1/wallet/withdrawals/{operationId}按提現操作 id 持久化查詢狀態。返回最新已知的 \{opera……。
GET/v1/perps/trades某個子錢包的 Hyperliquid 成交歷史（實時，非本地鏡像）……
GET/v1/perps/funding各永續合約倉位收到/支付的資金費率。
GET/v1/perps/transfers錢包範圍內的 Hyperliquid 充值、提現和帳戶劃轉記錄。
GET/v1/perps/order-history最近已成交/已撤銷的訂單。
GET/v1/perps/lighter-pnlLighter 子錢包的滾動已實現盈虧，從 Lighter 一級……
GET/v1/orders返回合約掛單，或通過 source=spot 返回現貨條件單。
POST/v1/perps/transfer將閒置 USDC 從一個永續合約子錢包轉移到另一個。僅限 USDC。涉及資金：預覽……
GET/v1/perps/sub-account/:subAccountId/idle-usdc某個永續合約子錢包的"可轉移"金額：扣除保證金後的閒置 USDC……

Autopilot

方法路徑描述
GET/v1/autopilot/managed/catalog列出選擇器可提供的託管策略類型，如夏普優化……
GET/v1/autopilot/managed/catalog/:strategyType/backtest某個託管策略類型的回測預覽（淨值曲線 + 核心指標）……
GET/v1/autopilot/managed/strategies所有託管策略，包含綁定子賬戶和標準化狀態。/autopilot……
GET/v1/autopilot/managed/aggregated-summary/autopilot KPI 欄和儀表盤託管策略模塊共用的聚合數據源。
GET/v1/autopilot/managed/xstrategy/deployments列出用戶的實時 XStrategy 部署（所有狀態），供 Autopilot 策略……
GET/v1/autopilot/managed/xstrategy/backtest/:backtestId某次部署的完整多資產回測報告（附加 /curves 可獲取淨值……）。
GET/v1/autopilot/managed/by-sub-account/:subAccountId詳情面板所需的子賬戶快照：綁定策略（或 null）……
POST/v1/autopilot/managed/strategies在子錢包上創建託管策略。涉及資金：省略 confirm（或傳……）觸發預覽。
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一次 round-trip 獲取多個標的的現貨/永續合約報價，用於行情看板……
GET/v1/quote/:ticker現貨價格、24 小時漲跌幅及傳統指標（市盈率、每股收益、股息率、52 周……）。
GET/v1/quote/crypto/:symbol某個加密資產的市值、FDV、24 小時成交量（USD）、24 小時漲跌幅、名稱、Logo 和鏈。
GET/v1/market/candles某個標的和時間間隔的 OHLC K 線。路由到相應數據源（Hyperli……）。
GET/v1/market/perps-price返回 Hyperliquid 或 Lighter 的永續市場目前價格和交易場所相關市場識別資訊。
GET/v1/market/sparkline僅含收盤價的緊湊序列，供 Web UI 內嵌迷你圖渲染使用。
GET/v1/market/trending返回供 Workbench 資產切換器使用的標準化熱門加密貨幣和股票項目。
GET/v1/market/search模糊匹配加密貨幣、股票、ETF、大宗商品、外匯的標的代碼和名稱……
GET/v1/markets/movers市場概覽看板中漲跌幅最大的標的。class=stocks（默認）返回……
GET/v1/markets/snapshot一次請求獲取市場概覽看板的宏觀數據包：主要指數報價（含……）。
GET/v1/markets/sectors看板熱力圖所需的 11 個 GICS 板塊日漲跌幅，通過……代理獲取。
GET/v1/markets/news看板的市場頭條資訊流，解析自 Yahoo Finance 的無密鑰 RSS。
GET/v1/markets/calendar來自 Nasdaq 無密鑰日曆的下一交易日財報數據，向前填充……

語音

方法路徑描述
GET/v1/voice/status語音服務是否已配置：stt_configured（轉錄提供商……）。
GET/v1/voice/voices語音選擇器選項列表：官方預設語音（ElevenLabs + OpenAI，始終……）。
GET/v1/voice/settings當前用戶可調的語音合成設置。傳 provider=openai 獲取語音……
PUT/v1/voice/settings持久化用戶調整的語音合成設置。傳 provider=openai 或 provide……
POST/v1/voice/cleanup刪除對話消息中已持久化的語音音頻（合成回覆 + 麥克風錄音）……
POST/v1/voice/transcribe通過已配置的語音提供商（Eleven……）轉錄上傳的音頻錄音。
POST/v1/voice/tts流式合成最多 4096 個字符文本的語音。提供商 body 通過管道……
POST/v1/sessions/:id/voice-audio將之前上傳的音頻文件（POST /v1/files）附加到助手消息……

圖片與視頻

方法路徑描述
GET/v1/media/settings返回 Fal.ai 連接狀態，以及獨立選擇的圖片和視頻……
PUT/v1/media/settings選擇 Fal.ai 鑑權方式，或設置默認圖片和視頻端點……
GET/v1/media/models列出某種輸出模態的活躍 Fal.ai 端點，包含動態推斷的……
POST/v1/media/models/refresh繞過五分鐘目錄緩存，刷新一種或兩種輸出模態。
GET/v1/media/models/schema返回已解析的 OpenAPI 輸入輸出 schema、字段順序和推斷……
POST/v1/media/providers/fal/oauth/init啟動 Fal.ai 設備流，返回用戶碼和驗證 URL。
GET/v1/media/providers/fal/oauth/poll輪詢設備流。成功響應將存儲可刷新的 OAuth 憑據……
POST/v1/media/providers/fal/api-key驗證並將 Fal.ai API key 存入結構化憑據存儲，然後……
DELETE/v1/media/providers/fal/auth/:kind刪除已保存的 Fal.ai 登錄檔案或 API key 覆蓋。另一種方式……

文件與產物

方法路徑描述
POST/v1/files將文件上傳到沙盒工作區。返回可供後續引用的 key……
GET/v1/files/:key將之前上傳的沙盒文件流式返回給調用方。
GET/v1/artifacts/:id按 id 獲取 Agent 生成的產物（圖表、電子表格、報告數據）……
GET/v1/artifacts列出 Web UI 文件頁面的已完成報告產物。可按 kind=ch…… 篩選。
DELETE/v1/artifacts永久刪除 1 至 200 個已歸檔的報告產物及其文件。每個……。
GET/v1/sandbox/files/:name讀取 Agent 寫入其每會話沙盒的文件。無法逃逸沙盒……

工作區文件

方法路徑描述
GET/v1/workspace/files列舉所有可編輯的工作區 md 文件，包含大小、mtime 和 sha256……
GET/v1/workspace/files/:name返回單個工作區 md 文件的內容及其 sha256。:name 須……
PUT/v1/workspace/files/:name原子替換工作區 md 文件。expected_sha256 為必填項，需傳入……
POST/v1/workspace/files/:name/restore-template用 src/workspace/templ…… 中的隨附模板覆蓋工作區文件。

研究

方法路徑描述
POST/v1/research直接從網關運行深度研究 pipeline，無需經過……
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返回不可變的模板、pipeline、Agent 設置、使用量和最終結果……

個性化與記憶

方法路徑描述
GET/v1/profile讀取 Agent 注入每個系統提示詞的重建個性化快照……
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/:name設置或清除 11 個行為標籤維度之一（如 risk、markets、……）。
DELETE/v1/profile/tags/:name等同於 PUT 傳 value: null，標籤被清除，Agent 重新推斷……
GET/v1/memory按 category 篩選最近記憶，或進行混合（BM25 + 向量）搜索……
GET/v1/memory/trading-cases舊版自由格式備註流（memories 表中 category = 'trading-cases' 的行）……
GET/v1/memory/research-cases按 topic 篩選的 /research 運行記憶。供研究回顧……
POST/v1/memory手動寫入一條 Agent 應始終記住的記憶。服務端標記 category=pe……
PATCH/v1/memory/:id編輯 source=user_manual 記憶的 statement、fact_type 或 tickers。其他來源……
DELETE/v1/memory/:id標記 deleted_at = now()。讀取路徑（FTS、列表、快照）會過濾該行……
POST/v1/memory/:id/restore清除 deleted_at。綁定 Web UI 撤銷提示（5 秒窗口），也可直接調用……
POST/v1/profile/refresh同步運行全部三項個性化重建（trading_summary / tags / memories）……
GET/v1/profile/trade-history-breakdown金融檔案儀表盤的三來源分解：本地 trade_hist……
GET/v1/profile/reference-wallets用戶的外部錢包地址觀察列表。
PUT/v1/profile/reference-wallets原子替換觀察列表。服務端驗證 EVM（0x + 40 位十六進制）和 Solan……

學習到的偏好

方法路徑描述
GET/v1/learned-preferences列出待處理的推斷行為偏好（proposed / active / deprecated……）。
POST/v1/learned-preferences/:id/:action轉換某條學習偏好的狀態。批准後變為 active 並納入……
GET/v1/learned-preferences/:id某條學習偏好 id 的完整記錄（描述、信號強度、歷史……）。
GET/v1/watchlist持久化在檔案中的用戶自定義標的觀察列表。
PUT/v1/watchlist替換觀察列表（最多 100 個標的）。
GET/v1/runtime-preferences返回子功能開關 schema、當前覆蓋值和已解析值……
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生成短期簽名 ack token，供下一次 PUT /v1/runtime-prefere…… 使用。
GET/v1/credentials/families返回提供商系列註冊表（網絡搜索、行情數據、向量 / embedding、雲……）。
PUT/v1/credentials/families/:id將單個提供商系列的覆蓋值寫入 ~/…… 的 dataSources 槽。
DELETE/v1/credentials/families/:id/field/:envVar刪除單個字段的覆蓋值（回退到環境變量派生的默認值）。
GET/v1/credentials/secrets返回扁平憑據槽（dataS……）中所有已配置的憑據 key。
PUT/v1/credentials/secrets/:key以 UPPER_SNAKE key 存儲值。消息類環境變量路由到消息……
GET/v1/credentials/custom返回 ~/.minara/credentials.json 自由格式 custom 槽中的所有 key……
PUT/v1/credentials/custom/:key以任意 key 在 custom 槽存儲值（原子 + 文件鎖）……
DELETE/v1/credentials/custom/:key從 custom 槽刪除單個 key。

通知

方法路徑描述
GET/v1/notifications最近的應用內通知（最新優先）及 unread_count。通知……
DELETE/v1/notifications刪除所有通知。返回 \{ ok, cleared \}。
POST/v1/notifications/read-all將所有未讀通知標記為已讀。返回 \{ ok, updated \}。
POST/v1/notifications/:id/read將單條通知標記為已讀（冪等）。返回 \{ ok: true, updated \}……
DELETE/v1/notifications/:id按 id 刪除單條通知。

學習與方法論

方法路徑描述
GET/v1/memory/trading-cases/stats交易案例儀表盤的 4 個數字快照：總案例數、近 30 天、勝……
GET/v1/memory/trading-cases/methodology-trend過去 N 周內前 N 個方法論的 outcome_alpha_return 周度時間序列……
GET/v1/memory/methodologies按 Wilson 置信度下界排名的前 N 個方法論，包含案例數、資產類別……
GET/v1/memory/methodology-cases讀取統一的 methodology_observations 臺賬。驅動審計臺賬視圖……
GET/v1/memory/trading-cases/:idmethodology_observations.id 的完整行 JSON。供右側詳情抽屜使用……
GET/v1/memory/trades來自統一 trade_executions 的近期 Agent 執行交易：操作、from/to……
GET/v1/memory/strategy-runs來自 strategy_runs 的用戶 Autopilot/託管策略運行記錄：名稱、創建者……
GET/v1/memory/facts按 fact_type 篩選的 FactLayer 行（observation.* / preference.* / goal.targ……）。

技能

方法路徑描述
GET/v1/skillsAgent 可激活的所有已註冊領域技能。每條記錄包含激活……
POST/v1/skills/reload將外部技能包重新鏡像到沙盒並重新註冊……

統計

方法路徑描述
GET/v1/stats按對話會話分桶的 token、費用和工具調用計數器。
POST/v1/telemetry/block-actionui_block 事件（UBP v1）的即發即忘點擊記錄。由 Web……

LLM 提供商

方法路徑描述
GET/v1/llm/default-modelAgent 循環當前用於新輪次的模型 id。
PUT/v1/llm/default-model將 Agent 循環切換到不同的模型 id。針對實時 avail…… 驗證。
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……
PUT/v1/report-style/preset應用某個內置報告樣式預設，同時保留其餘設計……
PUT/v1/report-style/css驗證並替換在選定預設和……之後應用的自定義 REPORT.css。

網關

方法路徑描述
GET/v1/gateway/providers已註冊到網關的入站消息提供商（Slack、Lark 等）。
POST/v1/gateway/providers/:id/fields/:envVar/reveal返回單個已屏蔽憑據字段（如 TELEGRAM_B……）的明文值。
POST/v1/gateway/providers/:id/resolve-chat-id用 gateway 已持有的 token 查詢機器人應發送到的 chat id；呼叫方無需接觸 token。輪詢式：found / awaiting_start / conflict / invalid_token。
POST/v1/gateway/providers/:id/oauth/init為 OAuth 類消息提供商（email-……）發起 Google OAuth 授權流程。
GET/studio/p/:pageId將生成的數據工作室儀表盤作為獨立 HTML 頁面在其專屬鏈接上提供服務……

遷移

方法路徑描述
GET/v1/migrate/manifest列出可導出的數據集（記憶、檔案、偏好、工作流）。
POST/v1/migrate/export將請求的 manifest 條目打包為可攜帶的 JSON 數據，用於備份/遷移……
POST/v1/migrate/import從之前導出的數據包恢復。對穩定 id（記憶、……）冪等。

管理

方法路徑描述
GET/v1/admin/script-risk/decisionsexecute_code / term…… 前置腳本風險閘門的決策審計日誌。
GET/v1/admin/script-risk/decisions/:id某次腳本風險閘門決策的完整審計記錄。
GET/v1/consent/grants列出從 cron / …… 運行的 Tier-3 / Tier-4 工具的創作時同意授權。
POST/v1/consent/grants記錄操作員對計劃自主運行的 Tier-3 / Tier-4 工具調用的授權。
GET/v1/consent/grants/:id返回某條同意授權的完整記錄。
DELETE/v1/consent/grants/:id將授權標記為已撤銷。後續在同一範圍內對該工具的自主調用……
POST/v1/consent/grants/requirements對草稿 cron / 工作流 / Agent 定義進行試運行掃描，檢測 Tier-3 / Tier-4 工具……

配置

方法路徑描述
GET/v1/config/financial-profile調試端點。返回當前加載的有效 FinancialProfileConfig……
GET/v1/config/financial-profile當前已解析的 FinancialProfileConfig，可用於調試重建原因……

鑑權

方法路徑描述
POST/v1/auth/elevenlabs/api-key保存用於語音合成和轉錄的 ElevenLabs key，經驗證後……
GET/v1/auth/status列出所有已配置的認證檔案（OpenAI / Anthropic / OpenRouter / Minara）。
POST/v1/auth/oauth/openai/init啟動 OpenAI Codex 設備碼登錄流程。返回 \{ flowId, userCode, verif……
GET/v1/auth/oauth/openai/poll按 flowId（來自 /v1/auth/oauth/open……）輪詢進行中的 OpenAI 設備碼流程。
GET/v1/auth/oauth/openai/callback已於 2026-05 停用。原 PKCE 回調目標現返回 410 Gone……
POST/v1/auth/oauth/openrouter/init啟動 OpenRouter OAuth PKCE 流程。
GET/v1/auth/oauth/openrouter/callbackOpenRouter 的 OAuth 重定向目標。
POST/v1/auth/openrouter/api-key跳過 OAuth 流程，直接註冊 OpenRouter API key。
POST/v1/auth/oauth/anthropic/init啟動 Anthropic 設備流複用路徑（複用已有的 Claude CLI 登錄）……
POST/v1/auth/oauth/anthropic/exchange通過交換 verifier 完成 Anthropic 設備流，獲取憑據。
DELETE/v1/auth/:provider刪除已存儲的認證檔案。:provider 為 openai | openai-api-key | anth……
POST/v1/auth/oauth/xai/init針對 auth.x.ai 啟動 SuperGrok 風格的 PKCE 流程。網關綁定回調……
GET/v1/auth/oauth/flows/:flowId在進程內編排器中查詢進行中的 Web OAuth 流程狀態……
DELETE/v1/auth/oauth/flows/:flowId取消進行中的 Web OAuth 流程，立即關閉綁定的回調端口……
POST/v1/auth/openai/api-key保存 OpenAI 平臺 API key（api.openai.com）。通過 GET /v1/models 驗證後持久化……
POST/v1/auth/anthropic/api-key保存 Anthropic 平臺 API key。通過 GET /v1/models 驗證後持久化……
POST/v1/auth/xai/api-key保存 xAI（Grok）API key。通過 GET /v1/models 驗證後持久化。
POST/v1/auth/kimi/api-key保存 Kimi API 平臺 key。通過官方 GET /v1/models 驗證後持久化。
POST/v1/auth/ollama/api-key保存 Ollama Cloud API key。針對已配置的 Ollama 主機驗證……
GET/v1/auth/preferred-provider從 credentials.json（llm……）讀取用戶顯式的"使用此提供商"覆蓋值。
PUT/v1/auth/preferred-provider設置或清除首選提供商覆蓋。實時探測所選憑據……
GET/v1/security/totp/status通過 Agent 的 normalizeTotpStatus 適配器投影 /auth/me。返回……
GET/v1/user/wallet-addresses供舊版用戶端相容使用的純錢包地址投影；新用戶端讀取統一 profile……
GET/v1/user/profile完整的已登入 Minara 帳戶資料，保留前端 /auth/me 欄位並加入穩定的 Agent 別名……
POST/v1/security/totp/generate為用戶產生新的 TOTP 密鑰，供其加入驗證器應用程式：otpauth:// 連結、預先渲染的 PNG data URL 與手動輸入用的 base32 密鑰。不返回備份碼……
POST/v1/security/totp/enable用戶提交 TOTP 碼證明已配置驗證器後，激活 TOTP……
POST/v1/security/totp/disable關閉 TOTP 但不刪除設備綁定。需同時提供新鮮的 TOTP 碼……
POST/v1/security/totp/verify已棄用。檢驗 6 位代碼是否匹配帳戶目前的密鑰，不改變任何狀態……
POST/v1/security/totp/unbind不可撤銷地刪除驗證器綁定。重新啟用需重新掃描……
POST/v1/security/email-code觸發上游 POST /auth/email/code，為用戶發送新的驗證碼……
PUT/v1/security/totp/settings儲存帳戶的新裝置登入與提領 TOTP 偏好。提領標記只被儲存和回顯，上游的提領守衛並不讀取它……
POST/v1/auth/minara/oauth/start啟動 Minara 平臺 OAuth 2.0 + PKCE 登錄。綁定回調……
POST[`/v1/auth

yahoo_finance

共享的實時股票兜底數據。優先通過 FMP 獲取標準化報價、日線歷史和公司摘要，失敗時回退至 Yahoo Finance。

獲取單個腳本風險決策

GET /v1/admin/script-risk/decisions/:id：單個腳本風險門控決策的完整審計記錄。

本頁目錄

鑑權健康檢查對話對話會話狀態與控制投資組合永續合約Autopilot行情數據語音圖片與視頻文件與產物工作區文件研究個性化與記憶學習到的偏好通知學習與方法論技能統計LLM 提供商主題網關遷移管理配置鑑權