API

プレビュー — CloudThinker REST API は早期アクセス段階です。エンドポイント、ペイロード、認証フローは一般提供前に変更される場合があります。プレビューへの参加はこちらからお問い合わせください。

CloudThinker API は、ウェブコンソールで利用可能な操作と同じものを、認証済み HTTPS エンドポイントとして公開しています。自社プロダクトへのクラウド運用の組み込み、ワークフローの自動化、または社内ツールとの CloudThinker 連携にご活用ください。

できること

機能	説明
会話のトリガー	`@agent #tool` プロンプトでエージェント会話をプログラムで開始し、アプリにレスポンスをストリーミングする
リソースの照会	AWS、GCP、Azure 横断でのクラウドリソース・コスト・トポロジーの統合インベントリを取得する
推奨事項の管理	コスト・セキュリティ・信頼性に関する推奨事項を一覧表示、承認、却下、またはコメントする
インシデントの操作	インシデントの作成、シグナルの添付、RCA の依頼、調査結果の取得を行う

API はベアラートークンヘッダーで渡す、ワークスペーススコープの API キーを使用します。

curl https://api.cloudthinker.io/v1/workspaces/{workspace_id}/resources \
  -H "Authorization: Bearer $CLOUDTHINKER_API_KEY"

フィールド	説明
スコープ	各キーは単一のワークスペースにバインドされます
権限	発行したメンバーのロールを継承します
ローテーション	ワークスペース設定からいつでもキーを失効させられます

API は URL パス（/v1/）でバージョン管理されています。破壊的変更は新しいバージョンでリリースされ、追加的な変更は現行バージョンでリリースされます。非推奨バージョンは後継バージョンのリリースから少なくとも12か月間は利用可能です。

MCP 対応 AI クライアントから CloudThinker ツールを使用する

ターミナルから CloudThinker の操作を実行する

ポーリングの代わりにイベント駆動の通知を受け取る

クラウドプロバイダーと SaaS システムを接続する