> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API

> 認証済み HTTPS エンドポイントを通じてワークスペース、エージェント、推奨事項、インシデントをプログラムで管理できます

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

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

***

## できること

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

***

## 認証

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

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

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

***

## エンドポイント一覧

| リソース                  | 用途                                                     |
| --------------------- | ------------------------------------------------------ |
| `/v1/workspaces`      | ワークスペースのメタデータとメンバー                                     |
| `/v1/conversations`   | エージェント会話の開始・一覧・再開                                      |
| `/v1/resources`       | 検出されたクラウドリソースインベントリ                                    |
| `/v1/recommendations` | コスト・セキュリティ・信頼性の推奨事項                                    |
| `/v1/incidents`       | インシデントのライフサイクルと RCA 結果                                 |
| `/v1/dashboards`      | 組み込みおよびカスタムダッシュボードデータ                                  |
| `/v1/skills`          | ワークスペースの Skills と実行                                    |
| `/v1/connections`     | クラウドおよび SaaS の[コネクション](/ja/guide/connections/overview) |

***

## バージョニング

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

***

## 関連

<CardGroup cols={2}>
  <Card title="MCP Server" icon="plug" href="/ja/guide/mcp/overview">
    MCP 対応 AI クライアントから CloudThinker ツールを使用する
  </Card>

  <Card title="CLI" icon="terminal" href="/ja/guide/cli/overview">
    ターミナルから CloudThinker の操作を実行する
  </Card>

  <Card title="Webhooks" icon="webhook" href="/ja/guide/webhooks/overview">
    ポーリングの代わりにイベント駆動の通知を受け取る
  </Card>

  <Card title="コネクション" icon="link" href="/ja/guide/connections/overview">
    クラウドプロバイダーと SaaS システムを接続する
  </Card>
</CardGroup>