Bundata API サーバーが提供する確認済みの HTTP ルート。
API リファレンス
認証、コレクション、検索
| メソッド | パス | 結果 |
|---|---|---|
| POST | /auth/login | Cookie セッション、または非ブラウザなら JWT |
| GET | /auth/me | ユーザー、ワークスペース、アクティブなワークスペース |
| POST | /auth/workspace | ブラウザセッションを workspaceId に結ぶ |
| POST | /auth/logout | ブラウザセッションを失効 |
| GET | /api/w/:workspaceId/collections | そのワークスペースのコレクション |
| POST | /api/collections/:id/documents/upload-url | 署名付きアップロードの手順(documentUploadRejection 検証付き) |
| POST | /api/collections/:id/documents/confirm | 201 とキューに入った処理 |
| POST | /api/collections/:id/retrieve | コレクションに対するハイブリッド検索 v2(includeTableFacts は任意) |
| POST | /api/collections/:id/answer | 構造化回答ブリーフ(answer-brief/v1)、検証済み回答、または学習済みフィールド回答(SSE は /answer/stream) |
| POST | /api/w/:workspaceId/connections/:id/source-ingest | S3 または PostgreSQL のキュー取り込み |
| POST | /api/w/:workspaceId/search | ワークスペース検索。semantic には agent:run が必要 |
| POST | /api/w/:workspaceId/search/answer | 根拠付き回答、または回答しない明示的な状態 |
AI プロバイダー、モデル、チャンキング
| メソッド | パス | 結果 |
|---|---|---|
| GET | /api/account/org/llm/providers | 接続済みプロバイダー(openai、anthropic、google)、既定プロバイダー、依存するワークスペース選択 |
| PUT | /api/account/org/llm/providers/:provider | 暗号化された組織プロバイダーキーの接続または差し替え |
| DELETE | /api/account/org/llm/providers/:provider | 組織プロバイダーキーの削除 |
| PUT | /api/account/org/llm/default-provider | 接続済みの openai または anthropic キーを既定プロバイダーに設定 |
| GET | /api/w/:wsId/ai-models | ワークスペースの AI モデルマップ、カタログモデル、チャットバックエンド |
| PUT / DELETE | /api/w/:wsId/ai-models/choices/:step | ステップに対するワークスペースモデル選択の設定または解除 |
| POST | /api/w/:wsId/ai-models/fill-gemini | Google のみの組織向けに未選択ステップへ推奨 Gemini モデルを設定 |
| GET / PUT | /api/collections/:id/chunk-sizes | コレクションのマルチサイズチャンキング戦略(single、three_sizes、custom)の取得・更新 |
コンテキストエンジン、コンテキストスタジオ、リネージ、テーブルファクト
| メソッド | パス | 結果 |
|---|---|---|
| GET | /api/w/:wsId/context-engine/status | 9 つの派生レイヤー全体のカバレッジと理由コード(?collectionId= は任意) |
| POST | /api/w/:wsId/context-engine/builds/dry-run | レイヤー構築前の対象文書数、モデル呼び出し回数、米ドルコストの見積もり |
| POST | /api/w/:wsId/context-engine/builds | コンテキストエンジンレイヤービルドの開始、:buildId/resume、または :buildId/cancel |
| GET / PUT | /api/w/:wsId/context-engine/switches[/:key] | 評価の証拠に基づく回答パススイッチ(graphrag.*、whole_document、field_answers)の取得・切り替え |
| PUT | /api/w/:wsId/context-engine/strictness | 主張検証の厳格度(remove、caveat、abstain)の設定 |
| GET / PUT / DELETE | /api/w/:wsId/context-engine/ranking[/assignment|/shadow] | ランキングプロファイルの確認、デプロイ既定の維持、シャドウ比較へのオプトイン |
| GET / POST | /api/w/:wsId/context-library/* | ビジネスコンテキストライブラリの項目、バージョン、引用の再アンカー、承認、スチュワード、/memory、/asked-before |
| GET / POST / PUT | /api/w/:wsId/context-sets/* | コンテキストセット、バージョン、提案、ロールバック、プレビュー、アクセス行 |
| GET / POST | /api/w/:wsId/context-explore/* | コンテキストスタジオ Explore の機能、ターン実行、非公開の保存済みチャット |
| GET / POST / PUT | /api/w/:wsId/context-enrichment/* | エンリッチメント設定、実行、提案受信箱、メンバーからの /suggestions |
| GET / POST / PUT / DELETE | /api/w/:wsId/learning/* | 回答フィードバック、保持された質問、学習設定、Gaps 一覧 |
| GET / POST / PUT | /api/w/:wsId/graph-review/* | 品質レビューキュー、項目、バイテンポラル判断、元に戻す操作、データセット昇格、/gate |
| GET / POST / PUT / DELETE | /api/w/:wsId/structured-context/* | PostgreSQL/MySQL スキーマ読み取り、dbt メタデータ読み取り、注釈、結合パス、クエリテンプレートのテスト・実行 |
| GET / POST / PUT / DELETE | /api/w/:wsId/ask-history/* | 非公開の Ask 会話履歴、常設メモ、オーナー保持設定、メンバーの /agent-memories |
| GET / POST | /api/w/:wsId/documents/:documentId/tables/* | 論理テーブル、型付きセルファクト、算術照合結果、finance ルール、および /api/w/:wsId/table-facts |
| POST | /api/w/:wsId/lineage/* | リネージの catalog-map、調査読み取り、タイムトラベル読み取り(entity-profile、value-series、history、diff、activity、themes) |
エージェント認証情報、エージェントコンテキスト API、MCP
| メソッド | パス | 結果 |
|---|---|---|
| GET / POST | /api/w/:wsId/agent-credentials | スコープ付き bdk_… エージェント認証情報の一覧・作成(および /:id/rotate、/:id/revoke、/:id/context-sets) |
| POST | /api/agent/v1/context-packs | トークン予算内の順位付け・重複排除・引用付き証拠パック(NDJSON ストリームは /context-packs/stream) |
| POST | /api/agent/v1/replays/:replayId | 記録されたコンテキストパックの検証または再計算 |
| POST | /api/agent/v1/context-sets/list | 利用可能なコンテキストセットの一覧(および /context-sets/get、/definitions/lookup、/verified-answers/match) |
| POST | /api/agent/v1/fields/list | コレクションの学習済みフィールド一覧(構造化フィルタ・ソート・集計プランの実行は /fields/query) |
| POST | /api/agent/v1/query-templates/run | 有効なコンテキストセットに属する承認済み読み取り専用 PostgreSQL クエリテンプレートの実行 |
| POST | /api/agent/v1/memories/* | ガバナンス付きエージェントメモリ(remember、recall、list、forget) |
| POST | /api/agent/v1/mcp | ステートレス Streamable HTTP MCP サーバー(bundata-workspace-context) |
古いページが概念的と記したパス(/extraction/runs や接頭辞なしの /v1 を含む)は、この契約ではありません。