REST API
Strata は OpenAPI 3.1 仕様で記述された REST API をベースに構築されています。ほとんどの連携では REST を直接呼び出すのではなく MCP サーバーを使用しますが、ツールやカスタムクライアント向けに完全な仕様も公開しています。
OpenAPI 仕様
機械可読な仕様はライブで提供され、デプロイ済み API と常に同期されます。直接開くか、Scalar、Redoc、Postman、Insomnia などのビューアーにインポートしてください：
openapi.json を開く仕様はエージェントやクローラー向けに /.well-known/api-catalog でも公開されています。
ベース URL とバージョニング
すべてのエンドポイントは API ホスト上の /api/v1 配下にあります。パスプレフィックスがバージョンを示します。
認証
リクエストにはベアラートークンを付与します。ブラウザセッションでは HttpOnly リフレッシュクッキーから発行される短期アクセストークンを使用し、プログラムによる MCP アクセスでは OAuth 2.1 を使用します。OAuth 2.1 はトークンの発行とリフレッシュを自動で処理します。
リソースエリア
この API は Strata ドメイン全体をカバーしています。主なリソースエリア：
- ドキュメント: CRUD、履歴、コメント、提案、アクセス、公開、画像
- Spaces: メンバーシップ、ソース、アクセス権、ハイブリッド検索
- 会社、組織、ティア: ワークスペース階層
- ユーザーとプロフィール: アカウント、メンバーシップ、公開プロフィール
- アクセスと共有: 権限、公開リンク、スペースの権限付与
- 認証と OAuth: セッション、テナント切り替え、MCP OAuth クライアント
- エージェントとタスク: プラットフォームおよびユーザーエージェントの呼び出し
- 管理とコンプライアンス: SSO、SCIM、監査、保持、請求
クライアントの生成
任意の OpenAPI 3.1 コードジェネレーターに上記の仕様を指定すると、お好みの言語で型付きクライアントを生成できます。
直接 REST を呼ぶよりツールを使いたいですか？MCPツールリファレンス をご覧ください。