APIキー

APIキーを使用すると、外部のシステムやスクリプトからワークスペースのリソースにプログラム的にアクセスできます。CI/CDパイプラインや自社システムとの連携に活用してください。

APIキーの作成

作成後に表示されるキー（ws_sk_...）をコピーしてください。**キーは作成時に一度だけ表示されます。**再表示はできないため、安全な場所に保管してください。

APIキーには、アクセスできるリソースと操作を制限するスコープを設定します。write スコープには read 権限が含まれます。

リソース	スコープ	説明
エージェント	`agents:read` / `agents:write`	エージェントの取得・作成・更新
セッション	`sessions:read` / `sessions:write`	セッションの取得・作成
ピープル	`people:read` / `people:write`	ピープルの取得・作成・更新
ナレッジ	`knowledges:read` / `knowledges:write`	ナレッジの取得・作成・更新
ポータル	`portals:read` / `portals:write`	ポータルの取得・作成・更新
インテグレーション	`integrations:read` / `integrations:write`	インテグレーションの取得・設定
メトリクス	`metrics:read`	メトリクスの取得（読み取り専用）

リクエストの Authorization ヘッダーに Bearer トークンとしてキーを指定します。

curl -H "Authorization: Bearer ws_sk_xxxxxxxxxxxx" \
  https://api.turnint.io/v1/api-keys

不要になったキーや漏洩の可能性があるキーは速やかに無効化してください。

無効化されたキーを使用したリクエストは即座に拒否されます。