APIリファレンス

カスタムインテグレーションを構築し、ワークフローを自動化し、アシスタントをプログラムで管理します。

注意: CollowAIのアプリケーションAPIはRailway上で稼働します。ウィジェットチャット、Webhook、プログラムからのアクセスにRESTエンドポイントを利用できます。詳細は以下のセクションをご覧ください。

HTTPエンドポイント

これらのHTTPエンドポイントは、ウィジェット埋め込みとWebhook処理に利用可能です:

POST/api/chat

アシスタントにメッセージを送信し、AIが生成した回答を受信します。埋め込みウィジェットで使用されます。アシスタントID、ユーザーメッセージ、オプションの会話コンテキストを受け付けます。

POST/api/webhooks/polar

Polar.sh支払いイベント（サブスクリプション、請求書など）用のWebhookレシーバー。Polar.shの組織設定で設定してください。

バックエンドAPI

CollowAIのアプリケーションAPIはRailway上で稼働します。すべてのエンドポイントはREST APIでアクセスできます。一般的なリソースグループは以下のとおりです:

アシスタント

アシスタントの作成、更新、削除、クエリ。設定、モデル、ステータスを管理します。

会話

会話の一覧、メッセージの送信、アシスタントのメッセージ履歴の取得。

ナレッジソース

ドキュメントのアップロード、データベース接続の管理、各アシスタントのナレッジベースの設定。

インテグレーション

第三者インテグレーションの接続と管理、同期ステータスの確認、手動同期のトリガー。

ウィジェット設定

ブランディング、ポジショニング、埋め込みチャット用カスタムCSSを含むウィジェット設定の構築と取得。

セカンドブレイン

構造化されたナレッジのクエリ。ドキュメントから抽出されたエンティティ、事実、トピック、関係性、競合。

請求とサブスクリプション

サブスクリプションステータスのクエリ、請求書の一覧、請求情報の管理。

クライアントSDKの使用

カスタムインテグレーションには、REST APIを直接使用してください:

# List assistants
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants

# Create an assistant
curl -X POST \
  -H "Authorization: Bearer assai_*" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Assistant"}' \
  https://api.collowai.com/api/v1/assistants

# Get Second Brain stats
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/stats

# List brain entities
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/entities

# List brain facts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/facts

# List brain topics
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/topics

# List brain relationships
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/relationships

# List brain conflicts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/conflicts

# Get brain extractions history
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/extractions

認証

APIリクエストは、ダッシュボード（設定 > APIキー）から生成されたAPIキーで認証されます。Authorizationヘッダーにキーを含めてください:

Authorization: Bearer YOUR_API_KEY