本文へ移動

エンドポイント一覧

すべて https://api.mithril.fund 配下。auth の pat は接続トークンの Bearer、cookie はブラウザのセッション（同一 origin の POST）、public は認証なし。提供していない wire（/v1/messages, /v1/responses, Gemini）は 405 です。

method path auth 本文と応答
GET /v1/models public モデルカタログ（team, route, availability）。
POST /v1/chat/completions pat / cookie OpenAI 互換の補完。tools, stream(emulated), max_tokens ≤ 32768。応答に billing / receiptId (+ usage, chargedMicroUSD)。
POST /x402/v1/chat/completions none (X-PAYMENT) x402 machine payment（ADR-2609190100）。認証なし、決済が認証。X-PAYMENT ヘッダが無ければ 402 で x402 challenge（scheme exact, network base, USDC, payTo, maxAmountRequired）。task は code-review 固定、tools/tool_choice は無視、max_tokens ≤ 4096。価格は /v1/chat/completions と同じ reservation-maximum の計算。無効な決済は 402、facilitator（x402.nexus）不達は 503。
GET /v1/research/status pat / cookie {status: eligible|pending, reason, freeTier, trust, scopes}。
POST /v1/research/jobs pat / cookie ジョブ作成。ヘッダ idempotency-key (uuid v4)。本文は strict shape {model, task, scopeId, max_tokens, messages}。202 queued。
GET /v1/research/job?jobId= pat / cookie {jobId, status, billing, model, receiptId, pollAfterMs, content?, toolCalls?, finishReason?}。202 while queued/running。
POST /v1/research/applications pat / cookie 研究者登録の申請 {verificationMode, policyVersion, consent, authorizedResearch, purpose, scope}。202。
POST /v1/research/ekyc/start pat / cookie 本人確認の開始 {scopeId, tasks} → Stripe の URL。
GET /v1/research/ekyc/status pat / cookie 本人確認の状態。
GET /v1/billing/catalog public プラン・単価・checkoutEnabled・purchasable。
GET /v1/billing/status pat / cookie {status, plan, balances[{scope, grantedMicroUSD, spentMicroUSD, reservedMicroUSD, availableMicroUSD}], autoRecharge?{enabled, thresholdMicroUSD, quantity, monthlyCapMicroUSD, spentThisMonthMicroUSD, capReached, disabledReason, lastAttempt}}。
POST /v1/billing/auto-recharge cookie {enabled, thresholdMicroUSD, quantity, monthlyCapMicroUSD} — 残高が閾値を下回ったら保存済みカードに quantity × $25 を請求する規則（既定 off、月次上限あり）。PAT では 403 browser-session-required。
POST /v1/billing/checkout cookie {sku, requestId} → Stripe Checkout の URL。PAT では 403。
POST /v1/billing/portal cookie 請求・解約の Customer Portal URL。
GET /v1/secure public guardrails / firewall / compliance の版と規則。
GET /v1/account/secure cookie このアカウントのスイッチ: 任意のガードレール規則と各コンプライアンス枠組みの on / off（{guardrails[{id, action, mandatory, on, requiredBy?}], compliance[{id, label, requires, on}]}）。
POST /v1/account/secure/toggle cookie スイッチを 1 つ動かす {kind: guardrail|compliance, id, on}。利用規約の block 規則は 403 rule-mandatory、有効な枠組みが要する規則は 409 required-by-framework（frameworks 付き）。
GET /v1/session cookie {valid, username, principalId}。
POST /v1/account/api-token cookie 接続トークンの発行（一度だけ表示）。
GET /v1/account/api-tokens cookie 発行済みトークンの一覧（id, label）。
POST /v1/account/api-token/revoke cookie トークンを 1 つ取り消す。
GET /v1/security/services public セキュリティサービスの公開カタログ。
POST /v1/security/govern public GRC（CSF 2.0 GV）: プロファイルのギャップ・リスク台帳・サプライヤー台帳を計算（保存しない）。GET は入力例。
POST /v1/security/respond public IR（CSF 2.0 RS）: 優先度・手順・報告期限・復旧基準を計算（保存しない）。GET は入力例。
POST /v1/security/recover public DR（CSF 2.0 RC）: 復旧ウェーブ・バックアップ検査・終了基準・連絡計画を計算（保存しない）。GET は入力例。
GET /v1/security/{edr,cmdb,email,vm,cspm,ztna,mdm,siem,grc,backup-dr} public 各製品の説明（ルール・上限・CSF）。
POST /v1/security/vm/findings public VM: 所見を重複排除・採点した台帳（GET は入力例）。
POST /v1/security/vm/match public VM: 部品・SBOM × OSV 勧告 × VEX の照合と CVSS（GET は入力例）。
POST /v1/security/cspm/assess public CSPM: クラウド資源または AWS/Azure/GCP/Kubernetes の応答 → 設定所見・攻撃経路・未評価（GET は入力例）。
POST /v1/security/ztna/authorize public ZTNA: ID × 端末状態 × 資源 → 許可 / 拒否と各検査（時刻は Worker の時計）。
POST /v1/security/ztna/netmap public ZTNA: ノードごとの到達可能性（未署名）。
POST /v1/security/mdm/compliance public MDM: 端末の準拠・非準拠・未測定と是正コマンド計画。
POST /v1/security/mdm/plan public MDM: コマンド計画と承認要否。
POST /v1/security/siem/correlate public SIEM: 複数ソースの相関 → alert・incident・通知・沈黙ソース。
POST /v1/security/siem/playbook public SOAR: 承認付き playbook の次の状態。
POST /v1/security/siem/respond public IR: 優先度・手順・報告期限（/v1/security/respond と同じ）。
POST /v1/security/grc/govern public GRC: プロファイル・リスク・サプライヤー（/v1/security/govern と同じ）。
POST /v1/security/grc/audit public GRC: BPMN 手続きに対する実行ログの逸脱と証跡欠落（判定は出さない）。
POST /v1/security/backup-dr/recover public DR: 復旧計画（/v1/security/recover と同じ）。
POST /v1/security/backup-dr/jobs public Backup: ジョブ記録 × ポリシー → 鮮度・連続失敗・リストアテスト・3-2-1-1-0。
GET /v1/security/solutions/spear-phishing public 標的型メール攻撃対策ソリューションの公開カタログ (第一次構成・攻撃チェーン・CSF/ATT&CK 参照)。
GET /v1/control-plane public サービス発見のプロファイル。

共通: エラーは {"error":{"code":…}}（Errors）。POST の本文上限は 2 MiB、content-type は application/json 必須。